Informationen zu den unterstützten Connectors für Application Integration.

Connectors-Aufgabe

Mit der Aufgabe Connectors können Sie mithilfe der in Integration Connectors verfügbaren sofort einsatzbereiten Connectors schnell und sicher eine Verbindung zu den verschiedenen Google Cloud-Diensten und anderen Geschäftsanwendungen herstellen.

Eine Liste aller unterstützten Connectors für Application Integration finden Sie in der Connector-Referenz.

Wichtig: Integration Connectors ist eine kostenpflichtige Komponente von Google Cloud. Informationen zu den Kosten und Gebühren für die Verwendung von Integrations-Connectors finden Sie unter Preise für Integrations-Connectors.

Hinweise

• Sie müssen in Ihrem Google Cloud-Projekt die IAM-Rolle „Connectors-Administrator“ (roles/connectors.admin) haben. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
• Weitere Informationen zu den allgemeinen Konzepten von Integration Connectors.
• Wenn Sie mithilfe eines Connectors eine Verbindung zu Google Cloud-Diensten und anderen Geschäftsanwendungen herstellen möchten, muss ein nutzerverwaltetes Dienstkonto an Ihre Integration angehängt werden. Wenn für die Integration kein nutzerverwaltetes Dienstkonto konfiguriert ist, wird standardmäßig das Standarddienstkonto ([e-mail]) zur Authentifizierung verwendet.
• Prüfen Sie, ob Ihr Dienstkonto die erforderliche IAM-Rolle hat. Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Connectors-Aufgabe hinzufügen

So fügen Sie die Connectors-Aufgabe in der Integration hinzu:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

   Die Seite Integrationen wird angezeigt. Dort sind alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

3. Wähle eine vorhandene Integration aus oder klicke auf Verknüpfung erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen:

   1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
      Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Integrationsübersicht in der Integrationssymbolleiste ändern oder aktualisieren.
      Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

   Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Tasks, um die Liste der verfügbaren Aufgaben aufzurufen.
5. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.

Connectors-Aufgabe konfigurieren

So konfigurieren Sie eine Connectors-Aufgabe:

Hinweis: Konfigurationsdetails wie die Authentifizierung variieren je nach Verbindungstyp.

1. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.

   Klicken Sie optional auf , um den Aufgabennamen zu ändern.

2. Klicken Sie auf Connector konfigurieren.
3. Sie können entweder eine vorhandene Verbindung in der Region auswählen oder eine neue Verbindung erstellen. Führen Sie die folgenden Schritte auf der Seite Connectors-Aufgaben-Editor aus, um eine vorhandene Verbindung zu konfigurieren:
1. Wählen Sie unter Connectors auswählen die Region der Verbindung aus.
2. Wählen Sie eine vorhandene Verbindung aus der Liste der verfügbaren Verbindungen in der ausgewählten Region aus.
3. Klicken Sie auf Next (Weiter).
4. Wählen Sie in der Liste Typ die Option Entitäten oder Aktionen aus.
   • Wenn Sie Entitäten auswählen, wird die Liste der unterstützten Entitäten für die Verbindung im Abschnitt Entitäten/Aktionen festlegen angezeigt. Wählen Sie eine Entität aus, gefolgt von dem Vorgang, den Sie für diese Entität ausführen möchten.
   • Wenn Sie Aktionen auswählen, wird die Liste der unterstützten Aktionen für die Verbindung in der Spalte Entitäten/Aktionen festlegen angezeigt. Wählen Sie eine Aktion für die Verbindung aus.
   Die unterstützten Entitäten und Aktionen hängen vom Connector-Typ ab. Eine Liste aller unterstützten Connectors für Application Integration finden Sie in der Connector-Referenz. Die unterstützten Aktionen und Entitäten für einen Connector finden Sie in der zugehörigen Dokumentation.

   Falls der Connector benutzerdefinierte SQL-Abfrage unterstützt, können Sie in der Liste Aktionen die Option Benutzerdefinierte Abfrage ausführen auswählen. Informationen zum Hinzufügen einer benutzerdefinierten SQL-Abfrage für einen BigQuery-Connector finden Sie unter Benutzerdefinierte SQL-Abfrage ausführen.

   Weitere Informationen zu Entitäten und Aktionen finden Sie unter Entitäten, Operationen und Aktionen.

   Hinweis: Nicht alle Verbindungstypen unterstützen Entitäten oder Aktionen. Wenn ein Verbindungstyp keine Aktionen oder Entitäten unterstützt, ist die entsprechende Liste mit Entitäten und Aktionen leer.
5. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Die folgende Abbildung zeigt ein Beispiellayout für die Seite Connectors-Aufgabeneditor.

Eingabe- und Ausgabevariablen von Aufgaben konfigurieren

Im Konfigurationsbereich der Connectors-Aufgabe werden die Variablen Aufgabeneingabe und Aufgabenausgabe angezeigt, die automatisch generiert werden basierend auf der Entität und dem Vorgang oder der Aktion, die im Dialogfeld Connector-Aufgabe konfigurieren ausgewählt wurden. Diese Variablen sind als Eingaben für die aktuelle Aufgabe, als Ausgaben für nachfolgende Aufgaben oder als Bedingungen in der aktuellen Integration konfigurierbar und zugänglich.

Zum Konfigurieren der Variablen Aufgabeneingabe oder Aufgabenausgabe klicken Sie auf die entsprechende Variable, um den Bereich Variable konfigurieren zu öffnen, und führen Sie die folgenden Schritte aus:

1. Geben Sie den Variablenwert in das Feld Standardwert ein.
2. Optional: Wählen Sie Als Eingabe für die Integration verwenden oder Als Ausgabe für die Integration verwenden aus.
3. Klicken Sie auf Speichern.

Weitere Informationen zu den Eingabe- und Ausgabeparametern der Connectors-Aufgabe finden Sie unter Entitätsvorgänge.

Entitätsvorgänge

Sie können CRUD-Vorgänge (Erstellen, Lesen, Aktualisieren, Löschen) für Entitäten eines Connectors ausführen. Jeder Entitätsvorgang hat einen anderen Satz von Eingabe- und Ausgabeparametern. In der folgenden Tabelle werden die Eingabe- und Ausgabeparameter der verschiedenen Entitätsvorgänge aufgelistet.

Name des Vorgangs	Eingabeparameter	Ausgabeparameter
Liste	listEntitiesPageSize listEntitiesPageToken listEntitiesSortByColumns filterClause	connectorOutputPayload listEntitiesNextPageToken
Abrufen	entityId	connectorOutputPayload
	Hinweis: Sie können den Get-Vorgang nur verwenden, um einen einzelnen Datensatz aus einer Tabelle mit einem Primärschlüssel abzurufen. Alternativ haben Sie die Möglichkeit, den List-Vorgang mit einer filterClause zu nutzen.
Erstellen	connectorInputPayload	connectorOutputPayload
Aktualisieren	connectorInputPayload entityId filterClause	connectorOutputPayload
Löschen	entityId filterClause	–

Eingabeparameter

In der folgenden Tabelle werden die Eingabeparameter für die verschiedenen Entitätsvorgänge dargestellt.

Parametername	Datentyp	Beschreibung
entityId	String	Eine eindeutige Kennung der Zeile, auf die Sie zugreifen möchten. In der Regel ist entityId ein Primärschlüsselwert einer Tabelle oder eines Datasets. Wenn Sie einen Wert für entityId angeben und die Tabelle oder das Dataset keine Primärschlüsselspalte hat, melden die Integrationen einen Laufzeitfehler und die Connectors-Aufgabe schlägt fehl. Wenn Sie beispielsweise eine bestimmte Zeile aus einer MySQL-Tabelle abrufen möchten, ist entityId der Primärschlüsselwert in der Tabelle. Hinweis:entityId ist für BigQuery nicht obligatorisch. Dieses Feld ist leer, wenn eine BigQuery-Tabelle keinen Primärschlüssel hat.
connectorInputPayload	JSON	Die tatsächlichen Daten, die einer Entität hinzugefügt oder dafür aktualisiert werden sollen. Das folgende Beispiel zeigt das JSON-Snippet von Zeilendaten, die in eine Tabelle eingefügt werden: { "employee_first_name": "John", "employee_emailID": "[e-mail]" } In diesem Beispiel sind employee_first_name und employee_emailID die Spaltennamen mit den Werten John und [e-mail].
filterClause	String	Schränkt das Ergebnis der Vorgänge auf Basis einer Bedingung ein. Weitere Informationen zum Hinzufügen einer Filterklausel finden Sie unter Filter für einen Vorgang hinzufügen.
listEntitiesPageSize	Integer	Gibt die Anzahl der Ergebnisse an, die auf einer Seite zurückgegeben werden sollen. Eine Seite ist eine logische Gruppierung der Datensätze einer Ergebnismenge. Die Nutzung von Seiten ist hilfreich, wenn Sie eine große Anzahl von Datensätzen in der Ergebnismenge erwarten. Wenn die Ergebnismenge groß ist, kann die Connectors-Aufgabe fehlschlagen, da mit der Connectors-Aufgabe nur eine begrenzte Menge an Daten verarbeitet werden kann. Wenn Sie die Ergebnismenge in kleinere Blöcke aufteilen, lässt sich dieses Problem vermeiden. Beispiel: Wenn Sie 1.000 Datensätze in Ihrer Ergebnismenge erwarten, können Sie die listEntitiesPageSize auf 100 setzen. Wenn also die Aufgabe Connectors zum ersten Mal ausgeführt wird, werden die ersten 100 Einträge zurückgegeben. Die nächsten 100 Einträge werden dann bei der zweiten Ausführung zurückgegeben, usw. Wichtig: Hinweis: Die Standardseitengröße beträgt 25 und die maximale Anzahl an Seiten, die von der Aufgabe unterstützt werden, beträgt 200. Sofern Ihre Tabelle oder Ihr Dataset keinen Primärschlüssel hat, müssen Sie den listEntitiesSortByColumns-Parameter auf die Verwendung von listEntitiesPageToken setzen. Verwenden Sie die listEntitiesPageSize-Parameter zusammen mit dem listEntitiesPageToken-Parameter, um die Seiten durchzugehen.
listEntitiesPageToken	String	Eine Seitenkennung (Token), mit der Sie auf eine bestimmte Seite zugreifen können. Sie haben die Möglichkeit, den Wert eines Seitentokens aus dem Ausgabeparameter listEntitiesNextPageToken abzurufen. Da jede Seite ein eindeutiges Token hat, können Sie damit flexibel auf jede Seite der Ergebnismenge zugreifen. Weitere Informationen zur Verwendung dieses Parameters finden Sie in der Beschreibung des Ausgabeparameters listEntitiesNextPageToken.
listEntitiesSortByColumns	String-Array	Spaltenname, nach dem Sie die Ergebnismenge sortieren möchten. Hinweis: Sie können die Ergebnismenge nur nach einer Spalte sortieren.

Ausgabeparameter

In der folgenden Tabelle werden die Ausgabeparameter für die verschiedenen Entitätsvorgänge dargestellt.

Parametername	Datentyp	Beschreibung
connectorOutputPayload	JSON	Die Ausgabe eines Vorgangs im JSON-Format.
listEntitiesNextPageToken	String	Eine vom System generierte Kennung für eine Seite. Sie können sich das Token als einen Zeiger vorstellen, mit dem Sie auf eine bestimmte Seite der Ergebnismenge zugreifen können. Wenn Sie die Ergebnismenge mithilfe des Parameters listEntitiesPageSize in mehrere Seiten aufgeteilt haben, benötigen Sie ein Verfahren, um auf die verschiedenen Seiten zuzugreifen. Das ist mit dem Ausgabeparameter listEntitiesNextPageToken möglich. Bei jeder Ausführung der Connectors-Aufgabe generiert das System ein Token für die nächste Seite und setzt den Wert von listEntitiesNextPageToken auf das neu generierte Token. Mit diesem Token können Sie dann auf die nächste Seite in der Ergebnismenge zugreifen. Für den Zugriff auf die nächste Seite müssen Sie für den Eingabeparameter listEntitiesPageToken den Tokenwert der nächsten Seite festlegen. Beispiel: Sie haben für den Parameter listEntitiesPageSize den Wert 2 festgelegt. Wenn die Connectors-Aufgabe zum ersten Mal ausgeführt wird, wird listEntitiesNextPageToken auf den Tokenwert ChoKC2VtcGxveWVlX2lkEgkRAAAAAAAA8D8YDw== gesetzt. Sie können dann diesen Tokenwert für den Eingabeparameter listEntitiesPageToken festlegen, um die nächste Seite bei der schrittweisen Ausführung der Connectors-Aufgabe abzurufen. Wenn Ihr Ergebnisset viele Seiten enthält, können Sie die Für jede Schleife-Aufgabe zum wiederholten Aufrufen der Connector-Aufgabe verwenden und die Datenzuordnung-Aufgabe nutzen, um Tokenwerten nach jeder Ausführung automatisch dem listEntitiesPageToken-Eingabeparameter zuzuweisen.

Filterklausel für Entitätsvorgänge

Sie können die von der Aufgabe Connectors verarbeiteten Datensätze mithilfe der Variable Filterklausel einschränken, die als Aufgabeneingabe verfügbar ist. Im Fall eines Löschvorgangs können Sie beispielsweise eine Filterklausel hinzufügen, um Datensätze mit einer bestimmten orderId zu löschen.

Die Filterklausel kann nur für die folgenden Entitätsvorgänge angewendet werden:

• Liste
• Löschen
• Aktualisieren

Wenn Sie einen dieser Vorgänge auswählen, wird im Bereich Aufgabeneingabe der Aufgabe Connectors das Feld Filterklausel automatisch angezeigt.

Filterklausel hinzufügen

Führen Sie die folgenden Schritte aus, um einen Fliterklausel hinzuzufügen:

1. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
2. Maximieren Sie den Bereich Aufgabeneingabe und klicken Sie auf die Stringvariable filterClause(Connectors).

   Das Dialogfeld Variable konfigurieren wird angezeigt.

3. Geben Sie die Filterklausel (nach der Klausel syntax) im Feld Standardwert ein.
4. Klicken Sie auf Speichern.

Syntax und Beispiele der Filterklausel

Eine Filterklausel hat das folgende Format:

FIELD_NAME CONDITION FILTER_VALUE

Beispiele

• OwnerId = '0053t000007941XAAQ'

• PoNumber < 2345

• OrderNumber = 00110 AND StatusCode = 'Draft'

• TotalAmount > 2500

• ShippingPostalCode = 94043 OR ShippingPostalCode = 77002

Wichtig: Geben Sie in der Filterklausel die Stringwerte in einfache Anführungszeichen ( ' ) oder doppelte Anführungszeichen ( " ) an, je nach Datenbank, die Sie verwenden. MySQL akzeptiert beispielsweise einfache und doppelte Anführungszeichen, während BigQuery nur einfache Anführungszeichen akzeptiert.

Variablen in der Filterklausel verwenden

Sie können eine Integrationsvariable nicht direkt in einer Filterklausel verwenden. Wenn Sie eine Integrationsvariable verwenden möchten, müssen Sie zuerst eine Datenzuordnungsaufgabe konfigurieren, um eine Zuordnung zwischen der Integrationsvariable und der Filterklausel zu erstellen.

Die folgende Tabelle zeigt eine Beispielzuordnung zwischen einer Integrationsvariable und der Variablen filterClause(Connectors):

Eingabe	Ausgabe
PRIMARY_KEY_ID = ' .CONCAT(INTEGRATION_VARIABLE) .CONCAT(')	filterClause(Connectors)

Dabei wird PRIMARY_KEY_ID = ' als Wert in die Eingabezeile eingegeben.

---

Inline-Verbindung erstellen

Mit der Connectors-Aufgabe können Sie eine neue Verbindung direkt in Integration Connectors erstellen.

Hinweise

• Connector-Aufgabe hinzufügen

Neue Verbindung erstellen

Führen Sie die folgenden Schritte aus, um eine neue Verbindung aus Application Integration zu erstellen:

1. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
2. Klicken Sie auf Connector konfigurieren.

   Die Seite Connectors-Aufgabeneditor wird angezeigt.

3. Überspringen Sie das Feld Region.
4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
5. Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
   Hinweis: Die folgende Anleitung enthält die allgemeinen Schritte zum Erstellen einer Verbindung. Während die meisten Schritte für alle Verbindungstypen gleich bleiben, können einige zusätzliche Schritte oder Details im Zusammenhang mit der Authentifizierung variieren.

   Wir empfehlen Ihnen außerdem, sich die entsprechende Dokumentation zum Verbindungstyp in Integration Connectors anzusehen.

   1. Wählen Sie im Schritt Standort den Standort für die Verbindung aus.
      1. Klicken Sie auf Region und wählen Sie einen Standort aus der Drop-down-Liste aus.
      2. Klicken Sie auf Next (Weiter).
   2. Geben Sie im Schritt Verbindungsdetails Details zur Verbindung ein:
      1. Connector: Wählen Sie aus der Drop-down-Liste den Connector-Typ aus, den Sie erstellen möchten. Informationen zur Liste der unterstützten Connectors finden Sie unter Alle Integrations-Connectors.
      2. Connector-Version: Wählen Sie eine verfügbare Version des ausgewählten Connector-Typs aus der Drop-down-Liste aus.
      3. Verbindungsname: Geben Sie einen Namen für die Verbindungsinstanz ein.
         Hinweis: Verbindungsnamen müssen die folgenden Kriterien erfüllen:

         • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
         • Buchstaben müssen Kleinbuchstaben sein.
         • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
         • Verbindungsnamen dürfen maximal 63 Zeichen haben.
      4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
      5. Optional: Aktivieren Sie Cloud Logging aktivieren, um die Logdaten der Verbindungsinstanz zu speichern.
      6. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
      7. Optional: Klicken Sie auf Erweiterte Einstellungen, um die Einstellungen für den Verbindungsknoten zu konfigurieren.

         Weitere Informationen finden Sie in der jeweiligen Verbindungsdokumentation unter Integrations-Connectors.

      8. Klicken Sie optional auf + LABEL HINZUFÜGEN, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
      9. Klicken Sie auf Next (Weiter).
   3. Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für die Verbindung an.
      1. Die in diesem Schritt ausgefüllten Authentifizierungsmethoden basieren auf dem Typ der erstellten Verbindung.

         Unterschiedliche Verbindungstypen verwenden unterschiedliche Authentifizierungsmethoden. Weitere Informationen finden Sie im Abschnitt Authentifizierung konfigurieren der entsprechenden Verbindungsdokumentation in Integrations-Connectors.

      2. Klicken Sie auf Next (Weiter).
   4. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
   5. Klicken Sie auf Erstellen.

---

Best Practices

• Informationen zu den Nutzungslimits für die Connectors-Aufgabe finden Sie unter Nutzungslimits.
• Informationen zur Fehlerbehebung bei einer fehlgeschlagenen Connectors-Aufgabe finden Sie unter Logs zur Fehlerbehebung und zum Verfolgen von Connector-Fehlern verwenden.

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.