Zum Inhalt springen

Google Pub Sub-Verbindung

Einführung

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

Hinweis

Um den Google Pub Sub-Connector zu verwenden, müssen Sie ein Dienstkonto erstellen, Rollen zuweisen und bestimmte Anmeldeinformationen in der Google Cloud Platform erhalten, wie in den Google Pub Sub-Voraussetzungen beschrieben.

Erstellen oder Bearbeiten einer Google Pub Sub-Verbindung

Eine neue Google Pub Sub-Verbindung wird mit dem Google Pub Sub-Connector von einem dieser Standorte erstellt:

Eine vorhandene Google Pub Sub-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Google Pub Sub-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Google Pub Sub-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 Google Pub Sub-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Google Pub Sub-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 der Anmeldeinformationen bereitgestellt wird, wie in den Google Pub Sub-Voraussetzungen beschrieben.

  • Client-Email: Geben Sie die client_email ein, die in der JSON-Datei der Anmeldeinformationen bereitgestellt wird, wie in den Google Pub Sub-Voraussetzungen beschrieben.

  • Private Schlüsselzeichenfolge: Geben Sie den private_key ein, der in der JSON-Datei der Anmeldeinformationen bereitgestellt wird, wie in den Google Pub Sub-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 in der private_key-Zeichenfolge vorhanden sind, müssen im Feld Private Schlüsselzeichenfolge durch einen Wagenrücklauf ersetzt werden. Andernfalls tritt ein Fehler auf, wenn die Verbindung getestet wird.

  • Proxy-Einstellungen verwenden (nur privater Agent): Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agents zu verwenden.

  • 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".

  • Ä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 fordert Sie auf, zu bestätigen, dass 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 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-String vorhanden. Ersetzen Sie alle Zeilenumbrüche durch einen Wagenrücklauf.
An error occurred: io.grpc.StatusRuntimeException: PERMISSION_DENIED: User not authorized to perform this action. Die Berechtigung pubsub.topics.list oder pubsublite.topics.list wurde dem Google Pub/Sub-Dienstkonto nicht gewährt. Siehe Google Pub Sub-Voraussetzungen für Informationen zur Zuweisung von Rollen und Berechtigungen.
An error occurred: io.grpc.StatusRuntimeException: PERMISSION_DENIED: Cloud Pub/Sub API has not been used in project 730922392691 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/pubsub.googleapis.com/overview?project=730922392691 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry. Die Google Pub/Sub-API wurde für das Projekt nicht aktiviert. Aktivieren Sie die Google Pub/Sub-API für das Projekt.

Nächste Schritte

Nachdem eine Google Pub Sub-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, 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 ihre 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:

  • Nachricht bestätigen: Bestätigt Nachrichten von einem Abonnement in Google Pub/Sub und ist als Ziel in einem Vorgang vorgesehen.

  • Thema erstellen: Erstellt Themen in Google Pub/Sub und ist als Ziel in einem Vorgang vorgesehen.

  • Nachricht abrufen: Ruft Nachrichten von einem Abonnement in Google Pub/Sub ab und ist als Quelle in einem Vorgang vorgesehen.

  • Nachricht veröffentlichen: Veröffentlicht Nachrichten an ein Thema in Google Pub/Sub und ist als Ziel in einem Vorgang vorgesehen.

  • Abonnement erstellen: Erstellt Abonnements in Google Pub/Sub und ist als Ziel in einem Vorgang vorgesehen.

  • Nachricht hören: Konsumiert Nachrichten von einem Google Pub/Sub-Abonnement und ist als Quelle in einem Vorgang vorgesehen.

  • Löschen: Löscht Abonnements oder Themen aus Google Pub/Sub und ist als Ziel in einem Vorgang vorgesehen.