Zum Inhalt springen

MongoDB-Verbindung

Einführung

Eine MongoDB-Verbindung, die mit dem MongoDB-Connector erstellt wurde, ermöglicht den Zugriff auf MongoDB. Sobald eine Verbindung konfiguriert ist, können Instanzen von MongoDB-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer MongoDB-Verbindung

Eine neue MongoDB-Verbindung wird mit dem MongoDB-Connector aus einem dieser Standorte erstellt:

Eine vorhandene MongoDB-Verbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer MongoDB-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die MongoDB-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 öffnende 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 MongoDB-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den MongoDB-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Benutzername: Geben Sie den Benutzernamen des MongoDB-Clusters ein.

  • Passwort: Geben Sie das Passwort des MongoDB-Clusters ein.

    Hinweis

    Wenn Sie sich nicht mit einem bestehenden MongoDB-Cluster verbinden, siehe MongoDB-Voraussetzungen für Informationen zur Einrichtung.

  • Verbindungsmethode: Wählen Sie die Methode aus, um Verbindungsinformationen einzugeben, entweder Formular oder Verbindungszeichenfolge.

    • Formular: Erweitert Felder, in denen Sie einen Host und eine Datenbank für eine MongoDB-Verbindung angeben.

      • Host: Geben Sie den Hostnamen des MongoDB-Clusters ein.

      • Datenbank: Geben Sie den Namen einer Datenbank ein, die im MongoDB-Cluster vorhanden ist.

      • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

        • Zusätzliche Parameter für die Verbindungszeichenfolge: Geben Sie zusätzliche Optionen für die MongoDB-Verbindung ein. Eine Liste der unterstützten Optionen finden Sie unter Optionen für Verbindungszeichenfolgen in der MongoDB-Dokumentation.

        • Verbindung über eine DNS-Seed-Liste: Wählen Sie diese Option, um sich über eine DNS-Seed-Liste anstelle des Standardverbindungsformats zu verbinden. Wenn diese Einstellung ausgewählt ist, wird auch empfohlen, SSL/TLS aktivieren auszuwählen. Weitere Informationen finden Sie im Abschnitt DNS-Seed-Liste-Verbindungsformat in der MongoDB-Dokumentation.

          Wichtig

          Sowohl Connect Using a DNS Seed List als auch Enable SSL/TLS sind erforderlich, um eine Verbindung zu MongoDB auf Azure Cosmos DB herzustellen.

        • Enable Retryable Writes: Wählen Sie aus, um Schreibvorgänge automatisch zu wiederholen. Weitere Informationen finden Sie unter Retryable Writes in der MongoDB-Dokumentation.

        • Enable Retryable Reads: Wählen Sie aus, um Lesevorgänge automatisch zu wiederholen. Weitere Informationen finden Sie unter Retryable Reads in der MongoDB-Dokumentation.

        • Enable SSL/TLS: Wählen Sie aus, um die Verbindung zu sichern.

    • Connection String: Erweitert die Felder, in denen Sie eine Verbindungszeichenfolge für eine MongoDB-Verbindung angeben.

      • Connection URL: Geben Sie die MongoDB-Verbindungszeichenfolge ein. Weitere Informationen zum akzeptierten Format der Zeichenfolge in diesem Feld finden Sie unter Connection String URI Format in der MongoDB-Dokumentation.

      • Optional Settings: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

        • Connect Using a DNS Seed List: Wählen Sie aus, um eine Verbindung über eine DNS-Seed-Liste anstelle des standardmäßigen Verbindungsformats herzustellen. Wenn diese Einstellung ausgewählt ist, wird auch empfohlen, Enable SSL/TLS auszuwählen. Weitere Informationen finden Sie unter DNS Seed List Connection Format in der MongoDB-Dokumentation.

          Wichtig

          Sowohl Connect Using a DNS Seed List als auch Enable SSL/TLS sind erforderlich, um eine Verbindung zu MongoDB auf Azure Cosmos DB herzustellen.

        • Wiederholbare Schreibvorgänge aktivieren: Wählen Sie diese Option, um Schreibvorgänge automatisch zu wiederholen. Weitere Informationen finden Sie unter Wiederholbare Schreibvorgänge in der MongoDB-Dokumentation.

        • Wiederholbare Lesevorgänge aktivieren: Wählen Sie diese Option, um Lesevorgänge automatisch zu wiederholen. Weitere Informationen finden Sie unter Wiederholbare Lesevorgänge in der MongoDB-Dokumentation.

        • SSL/TLS aktivieren: Wählen Sie diese Option, um die Verbindung zu sichern.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten 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 Organisationseinstellung Automatische Connector-Aktualisierung deaktivieren.

    Wichtig

    Wenn Ihre Verbindung fehlschlägt und alles korrekt aussieht, stellen Sie sicher, dass Sie die erforderlichen IP-Adressen, die in den MongoDB-Voraussetzungen beschrieben sind, auf die Whitelist gesetzt haben.

  • Ä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 MongoDB-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfstafel, 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 zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Ruft ein Objekt aus MongoDB ab und ist als Quelle in einer Operation vorgesehen.

  • Upsert: Aktualisiert ein bestehendes Objekt oder erstellt ein neues Objekt in MongoDB und ist als Ziel in einer Operation vorgesehen.

  • Einfügen: Platziert ein Objekt in MongoDB und ist als Ziel in einer Operation vorgesehen.

  • Aktualisieren: Platziert ein Objekt in MongoDB und ist als Ziel in einer Operation vorgesehen.

  • Löschen: Löscht ein Objekt aus MongoDB und ist als Ziel in einer Operation vorgesehen.