Azure Cosmos DB-Verbindung

Einführung

Eine Azure Cosmos DB-Verbindung, die mit dem Azure Cosmos DB-Connector erstellt wurde, ermöglicht den Zugriff auf Azure Cosmos DB. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, ü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 aus einem dieser Standorte erstellt:

Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
Der Global Endpoints-Seite (siehe Erstellen eines globalen Endpunkts in Global Endpoints).

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

Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
Der Komponenten-Registerkarte im Projektbereich (siehe Aktionenmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
Der Global Endpoints-Seite (siehe Bearbeiten eines globalen Endpunkts in Global Endpoints).

Konfigurieren einer Azure Cosmos DB-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Azure Cosmos DB-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine offene eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Azure Cosmos DB-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Azure Cosmos DB-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.
Kontenendpunkt: Geben Sie den Kontenendpunkt ein.
Authentifizierungsschema: Wählen Sie das Authentifizierungsschema, eines von:
- AccountKey
  - Kontoschlüssel: Geben Sie den Kontoschlüssel ein.
  - Token-Typ: Wählen Sie den Token-Typ, eines von:
    - master
    - resource
- AzureAD
  - OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine von:
    - AUS
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - GETANDREFRESH
    - REFRESH
      - 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 von:
    - AUS
      - OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
    - GETANDREFRESH
    - REFRESH
      - 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 von:
    - 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
    - JKSDATEI
    - JKSBLOB
    - PEMKEY_DATEI
    - PEMKEY_BLOB
    - ÖFFENTLICHE_SCHLÜSSEL_DATEI
    - ÖFFENTLICHE_SCHLÜSSEL_BLOB
    - SSHPUBLIC_SCHLÜSSEL_DATEI
    - SSHPUBLIC_SCHLÜSSEL_BLOB
    - P7BDATEI
    - PPKDATEI
    - XMLDATEI
    - XMLBLOB
  - OAuth-JWT-Zertifikat-Passwort: Geben Sie das Passwort für das OAuth-JWT-Zertifikat ein.
  - OAuth-JWT-Zertifikat-Subjekt: Geben Sie das Subjekt des OAuth-JWT-Zertifikats ein.
Schema: Geben Sie das Schema ein.
Proxy-Einstellungen verwenden: Wählen Sie aus, um die Proxy-Einstellungen des privaten Agenten zu verwenden.
Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Eigenschaften der erweiterten Konfigurationen angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen.
- Hinzufügen: Fügt eine Zeile zur Tabelle hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
- Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
- Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
- Bearbeiten: Ermöglicht das Bearbeiten eines vorhandenen Schlüssel-Wert-Paares. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
- Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
- Alle löschen: Löscht alle Zeilen aus der Tabelle.
Wichtig

Felder in der Tabelle Erweiterte Konfigurationsparameter zeigen das Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

Felder in der Tabelle Erweiterte Konfigurationsparameter unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.
Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Verbindung zum Azure Cosmos DB-Connector erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsfläche, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Designkomponentenpalette verfügbar. Für Details siehe 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 als Quelle in einem Vorgang vorgesehen.
Erstellen: Fügt einen Datensatz in eine Tabelle in Azure Cosmos DB ein und ist als Ziel in einem Vorgang vorgesehen.
Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Azure Cosmos DB und ist als Ziel in einem Vorgang vorgesehen.
Löschen: Löscht einen Datensatz aus einer Tabelle in Azure Cosmos DB und ist als Ziel in einem Vorgang vorgesehen.
Ausführen: Führt eine Prozedur in Azure Cosmos DB aus und ist als Ziel in einem Vorgang vorgesehen.