Zum Inhalt springen

Cloud Firestore-Verbindung

Einführung

Eine Cloud Firestore-Verbindung, die mit dem Cloud Firestore-Connector erstellt wurde, ermöglicht den Zugriff auf Google Cloud Firestore. Sobald eine Verbindung konfiguriert ist, können Instanzen von Cloud Firestore-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 Cloud Firestore-Verbindung

Eine neue Cloud Firestore-Verbindung wird mit dem Cloud Firestore-Connector von einem dieser Standorte aus erstellt:

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

Konfigurieren einer Cloud Firestore-Verbindung

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

  • Projekt-ID: Geben Sie die project_id ein, die in der JSON-Datei mit den Anmeldeinformationen bereitgestellt wird, wie in den Cloud Firestore-Voraussetzungen beschrieben.

  • Client-Email: Geben Sie die client_email ein, die in der JSON-Datei mit den Anmeldeinformationen bereitgestellt wird, wie in den Cloud Firestore-Voraussetzungen beschrieben.

  • Client-ID: Geben Sie die client_id ein, die in der JSON-Datei mit den Anmeldeinformationen bereitgestellt wird, wie in den Cloud Firestore-Voraussetzungen beschrieben.

  • Private Key ID: Geben Sie die private_key_id ein, die in der JSON-Datei mit den Anmeldeinformationen bereitgestellt wird, wie in den Cloud Firestore-Voraussetzungen beschrieben.

  • Privater Schlüssel: Geben Sie den private_key ein, der in der JSON-Datei mit den Anmeldeinformationen bereitgestellt wird, wie in den Cloud Firestore-Voraussetzungen beschrieben. Der private Schlüssel sollte in folgendem Format eingegeben werden:

    -----BEGIN PRIVATE KEY-----<private_key>-----END PRIVATE KEY-----

    Hinweis

    Alle Zeilenumbrüche (\n), die im private_key-String vorhanden sind, müssen im Feld Privater Schlüssel durch einen Wagenrücklauf ersetzt werden. Andernfalls tritt ein Fehler auf, wenn die Verbindung getestet wird.

  • 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 Organisation Richtlinie 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 vorhandene 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 fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Mögliche Verbindungsfehler

Dies sind mögliche Verbindungsfehler und deren Lösungen:

Fehler Ursache Lösung
An error occurred: com.google.common.base.Preconditions.checkArgument(ZLjava/lang/String;CLjava/lang/Object;)V Die Agent-Version ist zu alt. Stellen Sie sicher, dass die verwendete Agent-Version 10.60 oder höher ist.
An error occurred: java.io.IOException: Invalid PKCS#8 data Zeilenumbrüche (\n) sind im Privaten Schlüssel vorhanden. Ersetzen Sie alle Zeilenumbrüche durch einen Wagenrücklauf.

Nächste Schritte

Nachdem eine Cloud Firestore-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einer Operation bereitzustellen) oder als Ziele (um Daten in einer Operation zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Abfragen von Dokumenten innerhalb einer Sammlung in Cloud Firestore und ist als Quelle in einer Operation vorgesehen.

  • Erstellen: Erstellen von Dokumenten innerhalb einer Sammlung in Cloud Firestore und ist als Ziel in einer Operation vorgesehen.

  • Aktualisieren: Aktualisieren von Dokumenten innerhalb einer Sammlung in Cloud Firestore und ist als Ziel in einer Operation vorgesehen.

  • Löschen: Löschen von Dokumenten innerhalb einer Sammlung aus Cloud Firestore und ist als Ziel in einer Operation vorgesehen.