MongoDB-Connector in Jitterbit Studio

Zusammenfassung

Der MongoDB-Connector stellt Zugriff auf MongoDB bereit.

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

Der MongoDB-Connector wird über die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer MongoDB-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Aktivitätsinstanzen zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) verwendet werden sollen.

Zusammen werden eine bestimmte MongoDB-Verbindung und ihre Aktivitäten als MongoDB-Endpunkt bezeichnet:

• Abfrage: Ruft Daten aus einer MongoDB-Sammlung ab und ist zur Verwendung als Quelle in einem Vorgang vorgesehen.

• Upsert: Aktualisiert vorhandene Daten oder fügt neue Daten in eine MongoDB-Sammlung ein und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Einfügen: Fügt neue Daten in eine MongoDB-Sammlung ein und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Aktualisieren: Aktualisiert vorhandene Daten in einer MongoDB-Sammlung und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Löschen: Löscht Daten aus einer MongoDB-Sammlung und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

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

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

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

Der MongoDB-Connector verwendet den MongoDB Java Driver v4.1. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der Treiberdokumentation und in der MongoDB-Referenz.

Um den MongoDB-Connector zu verwenden, benötigen Sie Folgendes, wie in MongoDB-Voraussetzungen beschrieben:

• Ein MongoDB-Cluster und gültige Anmeldedaten für den Zugriff.
• Den Hostnamen des Clusters.
• Den Namen der Datenbank mit einer vorhandenen Sammlung.
• Alle relevanten Agent-IP-Adressen zur Zulassungsliste des Clusters hinzugefügt.

Fehlerbehebung

Wenn Probleme mit dem MongoDB-Connector auftreten, werden diese Fehlerbehebungsschritte empfohlen:

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

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

3. Aktivieren Sie die Debug-Protokollierung für Vorgänge (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

4. Bei Verwendung von privaten Agents können Sie die ausführliche Connector-Protokollierung für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agents hinzufügen:

   <logger name="org.jitterbit.connector.mongodb" level="DEBUG"/>
   

   Weitere Informationen zur ausführlichen Connector-Protokollierung finden Sie unter Ausführliche Protokollierung für Connectors mit Jitterbit-Privatagents.

5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

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