Azure Cosmos DB-Connector in Jitterbit Studio

Zusammenfassung

Der Azure Cosmos DB-Connector stellt Zugriff auf Azure Cosmos DB her.

Der Azure Cosmos DB-Connector bietet eine Schnittstelle zum Erstellen einer Azure Cosmos DB-Verbindung, die Grundlage für die Generierung von Azure Cosmos DB-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration mit Azure Cosmos DB über die Verbindung.

Man greift auf den Azure Cosmos DB-Connector über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten zu (siehe Palette der Designkomponenten).

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Verbindungsdokumentation

Zusätzlich zur Azure Cosmos DB-Verbindung siehe die umfassende Seite Azure Cosmos DB-Verbindungsdetails. Konfigurationsdetails wie diese sind auf dieser Seite enthalten:

• Erste Schritte: Erste Schritte zum Herstellen einer Verbindung.
• Erweiterte Funktionen: Benutzerdefinierte Ansichten und SSL-Konfiguration.
• Datenmodell: Das Datenmodell, das der Connector zur Darstellung des Endpunkts verwendet.
• Eigenschaften für erweiterte Konfigurationen: Eigenschaften, die definiert werden können, um eine Verbindung für grundlegende und erweiterte Konfigurationen zu konfigurieren.

Aktivitätsdokumentation

Eine bestimmte Azure Cosmos DB-Verbindung und ihre Aktivitäten werden zusammen als Azure Cosmos DB-Endpunkt bezeichnet:

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

• Erstellen: Fügt einen Datensatz in eine Tabelle in Azure Cosmos DB ein und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Azure Cosmos DB und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Löschen: Löscht einen Datensatz aus einer Tabelle in Azure Cosmos DB und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

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

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann nur mit privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren aussetzen.

Informationen zu den Schemaknoten und Feldern finden Sie in der Endpunktdokumentation.

Fehlerbehebung

Bei Problemen mit dem Azure Cosmos DB-Connector werden diese Schritte zur Fehlerbehebung empfohlen:

1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und um sicherzustellen, dass die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren nicht verwendet wird).

2. Stellen Sie sicher, dass alle Microsoft Entra ID-App-Registrierungen, die der Verbindung zugeordnet sind, nicht die veraltete Azure AD Graph verwenden.

3. Überprüfen Sie die Operationsprotokolle auf alle während der Ausführung der Operation geschriebenen Informationen.

4. Aktivieren Sie Operation Debug Logging für private Agents, um zusätzliche Protokolldateien und Daten zu generieren.

5. Aktivieren Sie Connector Verbose Logging für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agents hinzufügen:

   <logger name="org.jitterbit.connector.verbose.logging.CosmosDB" level="TRACE"/>
   

   Weitere Informationen zum Connector Verbose Logging finden Sie unter Verbose Logging für Connectors mit Jitterbit Private Agents.

6. Überprüfen Sie die Agent-Protokolle für weitere Informationen.

7. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.