Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.
Connectors-Aufgabe
Mit der Connector Aufgabe können Sie über die vorkonfigurierten Connectors schnell und sicher eine Verbindung zu den verschiedenen Google Cloud-Diensten und anderen Geschäftsanwendungen aus Ihrer Integration herstellen, indem Sie die vorkonfigurierten Connectors verfügbar in Integration Connectors nutzen.
Eine Liste aller unterstützten Connectors für Application Integration finden Sie in der Connector-Referenz.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 über einen Connector eine Verbindung zu Google Cloud-Diensten und anderen Geschäftsanwendungen herstellen möchten, muss Ihrer Integration ein nutzerverwaltetes Dienstkonto zugewiesen sein. Wenn für die Integration kein nutzerverwaltetes Dienstkonto konfiguriert ist, wird standardmäßig das Standarddienstkonto (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) 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:
- Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
- Klicken Sie im Navigationsmenü auf Integrations (Integrationen).
Auf der Seite Integrationen werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
- Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Verknüpfung erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen, gehen Sie so vor:
- Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
- Wählen Sie eine Region für die Integration aus.
- Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Verknüpfung im Bereich Integrationsübersicht ändern oder aktualisieren.
- Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
- Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um die Liste der verfügbaren Aufgaben und Connectors aufzurufen.
- Wenn Sie eine neue Verbindung konfigurieren möchten, klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor. Klicken Sie dann auf Connector konfigurieren, um die Verbindung zu konfigurieren.
- Wenn Sie bereits eine Verbindung haben, klicken Sie auf den Tab Connectors, um die zuletzt erstellten Verbindungen aufzurufen. Sie können auch nach einem Connector, einer Verbindung oder einer Aufgabe suchen, indem Sie den Namen in das Feld Suchen eingeben.
- Klicken Sie auf das konfigurierte Element Connectors und platzieren Sie es im Integrationseditor. Informationen zum Konfigurieren einer Connector-Aufgabe finden Sie unter Connector-Aufgabe konfigurieren.
Connectors-Aufgabe konfigurieren
So konfigurieren Sie eine Connectors-Aufgabe:
- Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
Klicken Sie optional auf , um den Aufgabennamen zu ändern.
- Klicken Sie auf Connector konfigurieren.
- Sie können entweder eine vorhandene Verbindung in der Region auswählen oder eine neue Verbindung erstellen. Führen Sie auf der Seite Connectors-Task-Editor die folgenden Schritte aus, um eine bestehende Verbindung zu konfigurieren.
Die folgende Abbildung zeigt ein Beispiellayout für die Seite Connectors-Aufgabeneditor.
- Wählen Sie im Abschnitt Verbindung auswählen die Region der Verbindung aus.
- Wählen Sie eine vorhandene Verbindung aus der Liste der verfügbaren Verbindungen in der ausgewählten Region aus.
- Klicken Sie auf Next (Weiter).
- Wählen Sie aus der Liste Type (Typ) die Option Entities (Entitäten) oder Actions (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 basieren auf dem Connector-Typ. Eine Liste aller unterstützten Connectors für Application Integration finden Sie in der Connector-Referenz. Informationen zu den unterstützten Aktionen und Entitäten für einen Connector finden Sie in der jeweiligen Connector-Dokumentation.
Wenn 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 den Connector finden Sie unter Aktion: Benutzerdefinierte SQL-Abfrage ausführen.
- Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.
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:
- Geben Sie den Variablenwert in das Feld Standardwert ein.
- Optional: Wählen Sie Als Eingabe für die Integration verwenden oder Als Ausgabe für die Integration verwenden aus.
- Klicken Sie auf Speichern.
Weitere Informationen zu den Eingabe- und Ausgabeparametern der Connectors-Aufgabe finden Sie unter Entitätsvorgänge.
Entitätsvorgänge und -aktionen
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 |
|
|
| Abrufen | entityId | connectorOutputPayload |
| Erstellen | connectorInputPayload | connectorOutputPayload |
| Aktualisieren |
|
connectorOutputPayload |
| Löschen |
|
– |
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 Beispiel: Wenn Sie eine bestimmte Zeile aus einer MySQL-Tabelle abrufen möchten, ist |
| 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": "test-05@test.com"
}
In diesem Beispiel sind |
| 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 |
| 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 |
| listEntitiesSortByColumns | String-Array | Spaltenname, nach dem Sie die Ergebnismenge sortieren möchten.
|
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 Beispiel: Sie haben für den Parameter 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 |
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:
- Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
- Maximieren Sie den Bereich Aufgabeneingabe und klicken Sie auf die Stringvariable filterClause(Connectors).
Das Dialogfeld Variable konfigurieren wird angezeigt.
- Geben Sie die Filterklausel (nach der Klausel Syntax) im Feld Standardwert ein.
- 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
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 Datenabgleichsaufgabe konfigurieren, um eine Zuordnung zwischen der Integrationsvariablen und der Filterklausel zu erstellen.Die folgende Tabelle zeigt eine Beispielzuordnung zwischen einer Integrationsvariable und der Variable filterClause(Connectors):
| Eingabe | Ausgabe |
|---|---|
PRIMARY_KEY_ID = ' .CONCAT(INTEGRATION_VARIABLE) .CONCAT(') |
filterClause(Connectors) |
PRIMARY_KEY_ID = ' als Wert in die Eingabezeile eingegeben.
Aktion: Benutzerdefinierte SQL-Abfrage ausführen
So erstellen Sie eine benutzerdefinierte Abfrage:
- Folgen Sie der detaillierten Anleitung zum Hinzufügen einer Connectors-Aufgabe.
- Wählen Sie beim Konfigurieren der Connector-Aufgabe als Typ der auszuführenden Aktion die Option Aktionen aus.
- Wählen Sie in der Liste Aktion die Option Benutzerdefinierte Abfrage ausführen aus und klicken Sie dann auf Fertig.
- Maximieren Sie den Bereich Task Input und führen Sie dann die folgenden Schritte aus:
- Geben Sie im Feld Zeitüberschreitung nach die Anzahl der Sekunden ein, die bis zur Ausführung der Abfrage gewartet werden soll.
Standardwert:
180Sekunden. - Geben Sie im Feld Maximale Zeilenanzahl die maximale Anzahl von Zeilen ein, die von der Datenbank zurückgegeben werden sollen.
Standardwert:
25. - Klicken Sie auf Benutzerdefiniertes Skript bearbeiten, um die benutzerdefinierte Abfrage zu aktualisieren. Das Dialogfeld Skripteditor wird geöffnet.
- Geben Sie im Dialogfeld Skripteditor die SQL-Abfrage ein und klicken Sie auf Speichern.
Sie können in einer SQL-Anweisung ein Fragezeichen (?) verwenden, um einen einzelnen Parameter darzustellen, der in der Liste der Abfrageparameter angegeben werden muss. Mit der folgenden SQL-Abfrage werden beispielsweise alle Zeilen aus der Tabelle
Employeesausgewählt, die den in der SpalteLastNameangegebenen Werten entsprechen:SELECT * FROM Employees where LastName=?
- Wenn Sie in Ihrer SQL-Abfrage Fragezeichen verwendet haben, müssen Sie den Parameter hinzufügen, indem Sie bei jedem Fragezeichen auf + Parameternamen hinzufügen klicken. Beim Ausführen der Integration ersetzen diese Parameter die Fragezeichen (?) in der SQL-Abfrage nacheinander. Wenn Sie beispielsweise drei Fragezeichen (?) hinzugefügt haben, müssen Sie drei Parameter in der richtigen Reihenfolge hinzufügen.
So fügen Sie Abfrageparameter hinzu:
- Wählen Sie in der Liste Typ den Datentyp des Parameters aus.
- Geben Sie im Feld Wert den Wert des Parameters ein.
- Wenn Sie mehrere Parameter hinzufügen möchten, klicken Sie auf + Suchparameter hinzufügen.
- Geben Sie im Feld Zeitüberschreitung nach die Anzahl der Sekunden ein, die bis zur Ausführung der Abfrage gewartet werden soll.
Schemaaktualisierung
Allen Entitäten und Aktionen ist ein Schema zugeordnet. Ein Aktionsschema hat beispielsweise folgende Parameterdetails: den Parameter und den zugehörigen Datentyp. Das Schema (Metadaten) für Entitäten und Aktionen wird von der Verbindung unter aus Ihrem Back-End. Falls das Schema aktualisiert wird, werden diese Aktualisierungen nicht automatisch in Ihren bestehenden Verbindungen widergespiegelt; müssen Sie das Schema manuell aktualisieren. So rufen Sie das aktualisierte Schema in Ihren vorhandenen Connector-Aufgaben auf:- Öffnen Sie unter „Integration Connectors“ die Seite Verbindungsdetails der Verbindung und klicken Sie auf Verbindungsschema aktualisieren
- In Application Integration müssen Sie Ihre vorhandene Connector-Aufgabe für dieselbe Verbindung neu konfigurieren.
Inline-Verbindung erstellen
Mit der Connectors-Aufgabe können Sie eine neue Verbindung direkt in Integration Connectors erstellen.
Hinweise
Neue Verbindung erstellen
Führen Sie die folgenden Schritte aus, um eine neue Verbindung über Application Integration zu erstellen:
- Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
- Klicken Sie auf Connector konfigurieren.
Die Seite Connectors-Aufgabeneditor wird angezeigt.
- Überspringen Sie das Feld Region.
- Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
- Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
- Wählen Sie im Schritt Standort den Standort für die Verbindung aus.
- Klicken Sie auf Region und wählen Sie einen Standort aus der Drop-down-Liste aus.
- Klicken Sie auf Next (Weiter).
- Geben Sie im Schritt Verbindungsdetails Details zur Verbindung ein:
- 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.
- Connector-Version: Wählen Sie eine verfügbare Version des ausgewählten Connector-Typs aus der Drop-down-Liste aus.
- Verbindungsname: Geben Sie einen Namen für die Verbindungsinstanz ein.
- Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
- Optional: Aktivieren Sie Cloud Logging aktivieren, um die Logdaten der Verbindungsinstanz zu speichern.
- Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
- 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.
- Klicken Sie optional auf + LABEL HINZUFÜGEN, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
- Klicken Sie auf Next (Weiter).
-
Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für die Verbindung an.
- 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.
- Klicken Sie auf Next (Weiter).
- Die in diesem Schritt ausgefüllten Authentifizierungsmethoden basieren auf dem Typ der erstellten Verbindung.
- Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
- Klicken Sie auf Erstellen.
- Wählen Sie im Schritt Standort den Standort für die Verbindung aus.
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.
Preise
Für den Cloud Pub/Sub-Trigger und den Salesforce-Trigger müssen Sie keinen Connector erstellen. Wenn Sie jedoch die Connectors-Aufgabe verwenden, um eine Verbindung zu Pub/Sub oder Salesforce herzustellen, wird Ihnen die Connector-Nutzung in Rechnung gestellt. Informationen zu den Preisen finden Sie unter Preise für Application Integration.
Kontingente und Limits
Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.
Nächste Schritte
- Alle Aufgaben und Trigger.
- Hier erfahren Sie, wie Sie eine Integration testen und veröffentlichen.
- Weitere Informationen zur Fehlerbehandlung.
- Weitere Informationen zu Ausführungslogs der Integration.