Zum Inhalt springen

Cloud Firestore Verbindung

Einführung

Eine Cloud Firestore Verbindung, die mit dem Cloud Firestore Connector erstellt wurde, richtet den Zugriff auf Google Cloud Firestore ein. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Cloud Firestore-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer Cloud Firestore Verbindung

Eine neue Cloud Firestore Verbindung wird mithilfe des Cloud Firestore Connectors von einem dieser Standorte aus erstellt:

Eine bestehende Cloud Firestore Verbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Cloud Firestore Verbindung

Jedes Benutzeroberflächenelement des Cloud Firestore Verbindungskonfigurationsbildschirms wird unten beschrieben.

Cloud Firestore Verbindungskonfiguration

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Cloud Firestore Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :. Dieser Name wird auch verwendet, um den Cloud Firestore Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

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

  • Kunden-Email: Geben Sie die client_email bereitgestellt durch die JSON-Datei mit den Anmeldeinformationen, wie in Cloud Firestore-Voraussetzungen beschrieben.

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

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

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

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

    Hinweis

    Alle Zeilenumbruchzeichen (\n) vorhanden in der private_key Die Zeichenfolge muss im Feld Privater Schlüssel durch einen Wagenrücklauf ersetzt werden. Andernfalls tritt beim Testen der Verbindung ein Fehler auf.

  • Test: Klicken Sie hier, 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 der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Mögliche Verbindungsfehler

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

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

Nächste Schritte

Nachdem eine Cloud Firestore Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Fragt Dokumente innerhalb einer Sammlung in Cloud Firestore ab und soll als Quelle in einer Operation verwendet werden.

  • Erstellen: Erstellt Dokumente innerhalb einer Sammlung in Cloud Firestore und soll als Ziel in einer Operation verwendet werden.

  • Aktualisieren: Aktualisiert Dokumente innerhalb einer Sammlung in Cloud Firestore und soll als Ziel in einer Operation verwendet werden.

  • Löschen: Löscht Dokumente innerhalb einer Sammlung aus Cloud Firestore und ist zur Verwendung als Ziel in einer Operation vorgesehen.