Zum Inhalt springen

Cloud Firestore-Verbindung in Jitterbit Studio

Einführung

Eine Cloud Firestore-Verbindung, die mit dem Cloud Firestore-Connector erstellt wird, stellt Zugriff auf Google Cloud Firestore her. Nach der Konfigurierung einer Verbindung können Sie Instanzen von Cloud Firestore-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Prozess) oder als Ziele (zur Verarbeitung von Daten in einem Prozess) verwendet werden.

Erstellen oder Bearbeiten einer Cloud Firestore-Verbindung

Eine neue Cloud Firestore-Verbindung wird mit dem Cloud Firestore-Connector von einer dieser Stellen aus erstellt:

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

Konfigurieren einer Cloud Firestore-Verbindung

Nachfolgend wird jedes Element der Benutzeroberfläche des Konfigurationsbildschirms der Cloud Firestore-Verbindung beschrieben.

Tipp

Felder mit einem -Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Symbol für Variablen, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem Sie auswählen können.

  • Connection Name: 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 zur Identifizierung des Cloud Firestore-Endpunkts verwendet, der sowohl eine spezifische Verbindung als auch ihre Aktivitäten referenziert.

  • Project Id: Geben Sie die project_id ein, die in der JSON-Datei mit den Anmeldeinformationen enthalten ist, wie unter Cloud Firestore-Voraussetzungen beschrieben.

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

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

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

  • Private Key: Geben Sie die private_key ein, die in der JSON-Datei mit den Anmeldeinformationen enthalten ist, wie unter Cloud Firestore-Voraussetzungen beschrieben. Der Wert wird bei der Eingabe ausgeblendet. Klicken Sie auf das -Symbol „Anzeigen", um den Wert anzuzeigen, und auf das -Symbol „Ausblenden", um ihn wieder auszublenden. Der private Schlüssel muss in folgendem Format eingegeben werden:

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

    Hinweis

    Alle in der private_key-Zeichenkette vorhandenen Zeilenumbruchzeichen (\n) müssen im Feld Private Key durch einen Zeilenumbruch ersetzt werden. Andernfalls tritt beim Testen der Verbindung ein Fehler auf.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Beim Testen der Verbindung wird die aktuelle Version des Connectors durch den oder die Agent(en) in der Agentgruppe heruntergeladen, die der aktuellen Umgebung zugeordnet ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch Verwendung der Organisationsrichtlinie Disable Auto Connector Update (Automatische Connector-Aktualisierung deaktivieren).

  • Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nach dem Öffnen einer vorhandenen Verbindungskonfiguration 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 Meldung 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 später ist.
An error occurred: java.io.IOException: Invalid PKCS#8 data Zeilenumbruchzeichen (\n) sind im Private Key vorhanden. Ersetzen Sie alle Zeilenumbruchzeichen durch einen Zeilenumbruch.

Nächste Schritte

Nach dem Erstellen einer Cloud Firestore-Verbindung platzieren Sie einen Aktivitätstyp auf der Design-Arbeitsfläche, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einen Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Design-Komponentenpalette verfügbar. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Fragt Dokumente in einer Sammlung in Cloud Firestore ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Erstellen: Erstellt Dokumente in einer Sammlung in Cloud Firestore und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Aktualisieren: Aktualisiert Dokumente in einer Sammlung in Cloud Firestore und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Löschen: Löscht Dokumente in einer Sammlung aus Cloud Firestore und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.