Zum Inhalt springen

Azure Cosmos DB Verbindung

Einführung

Eine Azure Cosmos DB Verbindung, die mit dem Azure Cosmos DB Connector erstellt wurde, richtet den Zugriff auf Azure Cosmos DB. Sobald diese Aktivitäten konfiguriert sind, interagieren sie über die Verbindung mit Azure Cosmos DB.

Erstellen oder Bearbeiten einer Azure Cosmos DB Verbindung

Eine neue Azure Cosmos DB Verbindung wird mit dem Azure Cosmos DB Connector von einem dieser Standorte aus erstellt:

Eine vorhandene Azure Cosmos DB Verbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Azure Cosmos DB Verbindung

Nachfolgend werden die einzelnen Benutzeroberflächenelemente des Azure Cosmos DB Verbindungskonfigurationsbildschirms beschrieben.

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Azure Cosmos DB Verbindung eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:) Dieser Name wird auch verwendet, um den Azure Cosmos DB Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

  • Endpoint: Geben Sie den Endpoint ein.

  • Authentifizierungsschema: Wählen Sie das Autorisierungsschema aus:

    • Kontoschlüssel

      • Kontoschlüssel: Geben Sie den Kontoschlüssel ein.

      • Token-Typ: Wählen Sie den Token-Typ, einen der folgenden:

        • Meister

        • Ressource

    • AzureAD

      • OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine der folgenden:

        • AUS

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        • GETANDREFRESH

        • AKTUALISIEREN

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
      • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

      • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

      • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

    • AzureServicePrincipal

      • Azure Mandant: Geben Sie den Azure Mandanten ein.

      • OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine der folgenden:

        • AUS

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        • GETANDREFRESH

        • AKTUALISIEREN

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
      • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

      • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

      • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

    • AzureServicePrincipalCert

      • Azure Mandant: Geben Sie den Azure Mandanten ein.

      • OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine der folgenden:

        • AUS

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        • GETANDREFRESH

        • AKTUALISIEREN

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
      • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

      • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

      • OAuth JWT-Zertifikat: Geben Sie das OAuth JWT-Zertifikat ein.

      • OAuth JWT-Zertifikatstyp: Wählen Sie den OAuth JWT-Zertifikatstyp aus, einen der folgenden:

        • BENUTZER

        • MASCHINE

        • PFXDATEI

        • PFXBLOB

        • JKSFILE

        • JKSBLOB

        • PEMKEY_FILE

        • PEMKEY_BLOB

        • ÖFFENTLICHE_SCHLÜSSELDATEI

        • PUBLIC_KEY_BLOB

        • SSHPUBLIC_KEY_FILE

        • SSHPUBLIC_KEY_BLOB

        • P7BFILE

        • PPKDATEI

        • XMLDATEI

        • XMLBLOB

      • OAuth JWT-Zertifikatskennwort: Geben Sie das Kennwort für das OAuth JWT-Zertifikat ein.

      • OAuth JWT-Zertifikatsbetreff: Geben Sie den Betreff des OAuth JWT-Zertifikats ein.

  • Schema: Geben Sie das Schema ein.

  • Proxy-Einstellungen verwenden: Wählen Sie diese Option aus, um private Agent-Proxy-Einstellungen zu verwenden.

  • Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Erweiterte Konfigurationseigenschaften angezeigt, die zum Hinzufügen zusätzlicher Konfigurationseigenschaften verwendet wird als Key-Value Paare.

    • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie für jede Eigenschaft ein Key-Value Paar ein.
    • Senden: Speichert das Key-Value Paar in der Tabelle. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
    • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
    • Bearbeiten: Ermöglicht Ihnen, ein vorhandenes Key-Value Paar zu bearbeiten. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
    • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn der Mauszeiger über eine vorhandene Zeile fährt.
    • Alles löschen: Löscht alle Zeilen aus der Tabelle.

    Wichtig

    Felder in der Tabelle Erweiterte Konfigurationen zeigen das variable Symbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

  • Test: Klicken Sie hier, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Azure Cosmos DB Connector-Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verwenden von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Ruft Datensätze aus einer Tabelle in Azure Cosmos DB ab und ist zur Verwendung als Quelle in einem Operation vorgesehen.

  • Erstellen: Fügt einen Datensatz in eine Tabelle in Azure Cosmos DB ein und soll als Ziel in einem Operation verwendet werden.

  • Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Azure Cosmos DB und soll als Ziel in einem Operation verwendet werden.

  • Löschen: Löscht einen Datensatz aus einer Tabelle in Azure Cosmos DB und soll als Ziel in einem Operation verwendet werden.

  • Ausführen: Führt eine Prozedur in Azure Cosmos DB aus und ist zur Verwendung als Ziel in einer Operation vorgesehen.