Zum Inhalt springen

Azure Cosmos DB-Connector für Jitterbit Studio

Zusammenfassung

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

Der Azure Cosmos DB-Connector bietet eine Schnittstelle zum Erstellen einer Azure Cosmos DB-Verbindung, die die Grundlage für die Generierung von Instanzen von Azure Cosmos DB-Aktivitäten bildet. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Azure Cosmos DB.

Der Azure Cosmos DB-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Hinweis

Dieser Connector kann nur mit privaten Agenten verwendet werden. Darüber hinaus handelt es sich um einen auf dem Connector SDK-basierenden Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Mit diesem Connector erstellte Endpunkte sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Verbindungsdokumentation

Neben der Azure Cosmos DB-Verbindung finden Sie auf der umfassenden Seite Details zur Azure Cosmos DB-Verbindung Konfigurationsdetails wie diese:

  • Erste Schritte: Erste Schritte zur Herstellung einer Verbindung.
  • Erweiterte Funktionen: Benutzerdefinierte Ansichten und SSL-Konfiguration.
  • Datenmodell: Das Datenmodell, das der Connector verwendet, um den Endpunkt darzustellen.
  • Erweiterte Konfigurationsparameter: Parameter, die definiert werden können, um eine Verbindung für grundlegende und erweiterte Konfigurationen zu konfigurieren.

Aktivitätsdokumentation

Zusammen werden eine spezifische Azure Cosmos DB-Verbindung und ihre Aktivitäten als Azure Cosmos DB-Endpunkt bezeichnet:

Azure Cosmos DB-Aktivitätstypen

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

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

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

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

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

Voraussetzungen und unterstützte API-Versionen

Der Azure Cosmos DB-Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Dieser Connector erfordert die Verwendung eines privaten Agents.

Siehe die Endpunktdokumentation für Informationen zu den Schemanodes und -feldern.

Fehlersuche

Wenn Probleme mit dem Azure Cosmos DB-Connector auftreten, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, die Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie wird verwendet).

  2. Stellen Sie sicher, dass keine Microsoft Entra ID-App-Registrierungen, die mit der Verbindung verbunden sind, die veraltete Azure AD Graph verwenden.

  3. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  4. Aktivieren Sie Betriebs-Debug-Protokollierung für private Agenten, um zusätzliche Protokolldateien und Daten zu generieren.

  5. Aktivieren Sie ausführliche Protokollierung für den Connector für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

    Weitere Informationen zur ausführlichen Protokollierung für Connectoren finden Sie unter Ausführliche Protokollierung für Connectoren, die Jitterbit-private Agenten verwenden.

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

  7. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Vorgängen.