CRUD-Vorgänge für eine MySQL-Datenbank ausführen

In diesem Tutorial erfahren Sie, wie Sie von einem Beispielintegration und Ausführen von Listen-, Get-, Create-, Update- und Delete-Vorgängen in einer MySQL-Datenbanktabelle.

Führen Sie für diese Anleitung die folgenden Aufgaben aus:

Hinweis

  • Prüfen Sie, ob Sie Zugriff auf Integrationen haben.
  • Führen Sie in Ihrem Google Cloud-Projekt folgende Schritte aus:

    • Weisen Sie dem Dienstkonto, das Sie zum Erstellen der Verbindung verwenden möchten, die folgenden Rollen zu:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor
    • Aktivieren Sie die folgenden Dienste:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Wenn diese Dienste für Ihr Projekt noch nicht aktiviert wurden, werden Sie beim Erstellen der Verbindung auf der Seite „Verbindung erstellen“ dazu aufgefordert.

  • Prüfen Sie, ob Sie Zugriff auf einen MySQL-Server haben, mit dem Sie eine Datenbank erstellen können.

Datenbank und Tabelle auf dem MySQL-Server einrichten

Stellen Sie eine Verbindung zu Ihrem MySQL-Server her und erstellen Sie eine Datenbank und eine Tabelle für die Verwendung in dieser Anleitung.
  1. Führen Sie den folgenden Befehl über ein System aus, auf dem ein MySQL-Client installiert ist, um eine Verbindung zu Ihrem MySQL-Server herzustellen:
    mysql --host=MySQL server host name or IP address --port=MySQL server port number -uusername -ppassword
    Ersetzen Sie in diesem Beispiel Folgendes:
    • MySQL server host name or IP address durch den Namen oder die IP-Adresse des MySQL-Servers.
    • MySQL server port number durch die Portnummer für den MySQL-Server.
    • username durch den Nutzernamen für den MySQL-Server.
    • password durch das Passwort für den MySQL-Server.
  2. Führen Sie den folgenden Befehl in Ihrem MySQL-Client aus, um eine MySQL-Datenbank zur Verwendung in dieser Anleitung zu erstellen:
    CREATE DATABASE tutorialDB;
  3. Führen Sie den folgenden Befehl in Ihrem MySQL-Client aus, um eine Tabelle zur Verwendung in dieser Anleitung zu erstellen:
    create table employee
      (
      employee_id int auto_increment primary key,
      employee_first_name varchar(500) NOT null,
      employee_last_name varchar(500) NOT null,
      employee_emailID varchar(500)
      ); 
  4. Führen Sie den folgenden Befehl in Ihrem MySQL-Client aus, um der von Ihnen erstellten Tabelle employee Zeilen hinzuzufügen:
    INSERT INTO employee (employee_first_name,employee_last_name,employee_emailID) values ("Peter","Dilliard","test-01@test.com");
    INSERT INTO employee (employee_first_name,employee_last_name,employee_emailID) values ("Meaghan","Webb","test-02@test.com");
    
  5. Prüfen Sie mit dem folgenden Befehl, ob die Tabelle erstellt und Zeilen hinzugefügt wurden:
    SELECT * FROM employee;
    Die folgenden Tabellenzeilen werden angezeigt:
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | test-01@test.com |
    |           2 | Meaghan             | Webb               | test-02@test.com |
    +-------------+---------------------+--------------------+------------------+
    

MySQL-Verbindung erstellen

Damit eine Integration eine Verbindung zu Ihrer MySQL-Datenbank herstellen kann, erstellen Sie eine neue Verbindung zu Ihrer MySQL-Datenbank.

  1. Klicken Sie auf + neu erstellen, um die Seite Verbindung erstellen zu öffnen.
  2. Wählen Sie im Abschnitt Standort den Standort für die Verbindung aus.
    1. Wählen Sie in der Liste Region die Region aus, in der Sie die Verbindung erstellen möchten.

      Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

    2. Klicken Sie auf Next (Weiter).
  3. Geben Sie im Abschnitt Connection Details (Verbindungsdetails) die folgenden Informationen ein:
    1. Wählen Sie aus der Connector-Liste MySQL (Vorabversion) aus.
    2. Wählen Sie aus der Liste Connector-Version die Connector-Version aus.
    3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein.

      Verbindungsnamen müssen die folgenden Kriterien erfüllen:

      • Verwenden Sie Buchstaben, Ziffern oder Bindestriche.
      • Buchstaben müssen Kleinbuchstaben sein.
      • Namen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
      • Namen dürfen nicht länger als 49 Zeichen sein.
    4. Optional: Fügen Sie im Feld Beschreibung eine Beschreibung der Verbindungsinstanz hinzu.
    5. Optional: Aktivieren Sie Cloud Logging.
    6. Wählen Sie in der Liste Dienstkonto ein Dienstkonto mit den erforderlichen Rollen aus.
    7. Geben Sie in das Feld Datenbankname den Namen der MySQL-Datenbank ein.
    8. Konfigurieren Sie optional die Einstellungen für den Verbindungsknoten:

      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

    9. Proxy verwenden: Aktivieren Sie dieses Kästchen, um einen Proxyserver für die Verbindung zu konfigurieren. Legen Sie dann die folgenden Werte fest:
      • Proxy Auth Scheme (Proxy-Authentifizierungsschema): Wählen Sie den Authentifizierungstyp für die Authentifizierung beim Proxyserver aus. Die folgenden Authentifizierungstypen werden unterstützt:
        • Standard: Basis-HTTP-Authentifizierung.
        • Digest: Digest-HTTP-Authentifizierung.
      • Proxy-Nutzer: Ein Nutzername, der für die Authentifizierung beim Proxyserver verwendet werden soll.
      • Proxy-Passwort: Das Secret Manager-Secret des Nutzerpassworts.
      • Proxy-SSL-Typ: Der SSL-Typ, der beim Herstellen einer Verbindung zum Proxyserver verwendet werden soll. Die folgenden Authentifizierungstypen werden unterstützt:
        • Automatisch: Standardeinstellung. Wenn die URL eine HTTPS-URL ist, wird die Option „Tunnel“ verwendet. Wenn es sich bei der URL um eine HTTP-URL handelt, wird die Option „NEVER“ (NIE) verwendet.
        • Immer: Für die Verbindung ist immer SSL aktiviert.
        • Nie: Für die Verbindung ist SSL nicht aktiviert.
        • Tunnel: Die Verbindung erfolgt über einen Tunneling-Proxy. Der Proxyserver öffnet eine Verbindung zum Remote-Host und der Traffic fließt über den Proxy hin und her.
      • Geben Sie im Abschnitt Proxyserver Details zum Proxyserver ein.
        1. Klicken Sie auf + Ziel hinzufügen.
        2. Wählen Sie einen Zieltyp aus.
          • Hostadresse: Geben Sie den Hostnamen oder die IP-Adresse des Ziels an.

            Wenn Sie eine private Verbindung zu Ihrem Back-End-System herstellen möchten, gehen Sie so vor:

            • Erstellen Sie einen PSC-Dienstanhang.
            • Erstellen Sie einen Endpunktanhang und geben Sie dann die Details des Endpunktanhangs in das Feld Hostadresse ein.
    10. Optional: Klicken Sie auf + Label hinzufügen, um der Verbindung ein Label hinzuzufügen.
    11. Klicken Sie auf Next (Weiter).
    12. Geben Sie im Abschnitt Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten.
      • Wählen Sie in der Liste Zieltyp eine Hostadresse aus.
        • Wählen Sie aus der Liste Hostadresse aus, um den Hostnamen oder die IP-Adresse für das Ziel anzugeben.
        • Wenn Sie eine private Verbindung zu Ihren Backend-Systemen herstellen möchten, wählen Sie in der Liste Endpunktanhang und dann den erforderlichen Endpunktanhang aus der Liste Endpunktanhang aus.

        Wenn Sie eine öffentliche Verbindung zu Ihren Back-End-Systemen mit zusätzlicher Sicherheit herstellen möchten, können Sie statische ausgehende IP-Adressen für Ihre Verbindungen konfigurieren und dann Ihre Firewallregeln konfigurieren, um nur bestimmte statische IP-Adressen zuzulassen.

        Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + Ziel hinzufügen.

      • Klicken Sie auf Next (Weiter).
    13. Im Abschnitt Authentication (Authentifizierung) können Sie Anmeldedaten angeben:
      • Geben Sie im Feld Nutzername den MySQL-Nutzernamen für die Verbindung ein.
      • Geben Sie im Feld Passwort das Secret Secret Manager mit dem Passwort ein, das dem MySQL-Nutzernamen zugeordnet ist.
        • Falls Sie bereits ein Secret erstellt haben und dieses nicht in der Liste aufgeführt ist, gehen Sie so vor: wählen Sie Enter Secret Manuell aus. Kopieren Sie im Dialogfeld Secret nach Ressourcen-ID hinzufügen die Ressourcen-ID aus dem Secret Manager und fügen Sie sie ein.
          • Um die neueste Version zu verwenden, kopieren Sie die Ressourcen-ID aus dem übergeordneten Secret im Format "projects/project-number/secrets/secret-name" und fügen Sie sie ein.
          • Wenn Sie eine bestimmte Version auswählen möchten, kopieren Sie die Ressourcen-ID für diese Version im Format "projects/project-number/secrets/secret-name/versions/1" und fügen Sie sie ein.

          Klicken Sie auf Secret hinzufügen, um das Secret hinzuzufügen.

        • Wenn Sie noch kein Secret für MySQL erstellt haben, klicken Sie auf Neues Secret erstellen. Geben Sie im Dialogfeld Secret erstellen die folgenden Details ein:
          • Geben Sie im Feld Name den folgenden Namen ein.
          • Geben Sie im Feld Secret-Wert den Inhalt des Secrets ein oder laden Sie eine Datei hoch, die das Secret enthält.
          • Klicken Sie auf Secret erstellen.
      • Wählen Sie aus der Liste Secret-Version die Version des Passwort-Secrets aus der Liste der verfügbaren Versionen im Drop-down-Menü aus.
      • Klicken Sie auf Next (Weiter).
  4. Prüfen Sie im Abschnitt Überprüfen Ihre Verbindungs- und Authentifizierungsdetails.
  5. Klicken Sie auf Erstellen.

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

  • Nutzername und Passwort
    • Nutzername: Der Mysql-Nutzername für die Verbindung.
    • Kennwort: Secret Manager-Secret mit dem Passwort, das dem Mysql-Nutzernamen zugeordnet ist.

Integration zur Verwendung der MySQL-Verbindung konfigurieren

Wenn Sie die gerade erstellte MySQL-Verbindung in einer Integration verwenden möchten, fügen Sie eine Connectors-Aufgabe zusammen mit einem API-Trigger hinzu. Der API-Trigger ist über eine Edge-Verbindung mit der Connectors-Aufgabe verbunden.

Neue Integration erstellen

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

    Zu Integration Connectors

  2. Klicken Sie im Navigationsmenü auf Integrationen.

    Die Seite Integrations List (Integrationsliste) wird angezeigt.

  3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf INTEGRATION ERSTELLEN klicken.

    Dadurch wird die Integration auf der Seite des Integrationseditors geöffnet.

  4. Klicken Sie im Integrationseditor auf Aufgabe/Trigger hinzufügen > Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  5. Klicken Sie auf NEU ERSTELLEN.
  6. Geben Sie einen Namen und (optional) eine Beschreibung im Dialogfeld Integration erstellen ein.
  7. Klicken Sie auf Erstellen, um den Integrationseditor zu öffnen.

API-Trigger hinzufügen und konfigurieren

So fügen Sie der API einen API-Trigger hinzu und konfigurieren ihn:

  1. Wählen Sie im Integrationseditor Aufgabe/Trigger hinzufügen > Trigger aus, um eine Liste der verfügbaren Trigger aufzurufen.
  2. Ziehen Sie das Element API-Trigger in den Integrationseditor.

Connectors-Aufgabe hinzufügen und konfigurieren

Führen Sie die folgenden Schritte aus, um eine Connectors-Aufgabe zu konfigurieren und alle Entitäten in der Tabelle employee aufzulisten:

  1. Wählen Sie im Integrationseditor Aufgabe/Trigger hinzufügen > Aufgaben aus, um die Liste der verfügbaren Aufgaben aufzurufen.
  2. Ziehen Sie das Element Connectors in den Integrationseditor.
  3. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Aufgabe aufzurufen.
  4. Klicken Sie auf Aufgabe konfigurieren.

    Das Dialogfeld Connector-Aufgabe konfigurieren wird angezeigt.

  5. Führen Sie im Dialogfeld Connector-Aufgabe konfigurieren die folgenden Schritte aus:
    1. Wählen Sie die Verbindungsregion aus, in der Sie die MySQL-Verbindung erstellt haben.
    2. Nachdem eine Region ausgewählt wurde, wird die Spalte Verbindung angezeigt. Wählen Sie die von Ihnen erstellte MySQL-Verbindung aus der Liste der verfügbaren Verbindungen aus.
    3. Wenn eine Verbindung ausgewählt ist, wird die Spalte Typ angezeigt. Wählen Sie Entitäten und dann Mitarbeiter aus der Liste der verfügbaren Entitäten aus.
    4. Sobald ein Typ ausgewählt ist, wird die Spalte Vorgang angezeigt. Wählen Sie Liste aus.
    5. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und das Dialogfeld zu schließen.

API-Trigger-Element mit dem Connectors-Aufgabenelement verbinden

Fügen Sie dann eine Edge-Verbindung hinzu, um den API-Trigger mit der Connectors-Aufgabe zu verbinden. Eine Edge-Verbindung ist eine Verbindung zwischen zwei Elementen in einer Integration. Weitere Informationen zu Edges und Edge-Bedingungen finden Sie unter Edges.

Klicken Sie unten im API-Trigger-Element auf den Steuerungspunkt Fork, um die Edge-Verbindung hinzuzufügen. Ziehen Sie die Edge-Verbindung am Steuerpunkt Join per Drag-and-drop an den oberen Rand des Connectors-Aufgabenelements.

Integration testen

So testen Sie die Integration:

  1. Klicken Sie in der Symbolleiste des Integrationseditors auf die Schaltfläche Test (Testen).
  2. Ändern Sie bei Bedarf den Wert für Ausführungsfrist (in Minuten) und klicken Sie dann auf Integration testen.
  3. Sobald die Integration erfolgreich abgeschlossen wurde, wird im Bereich Test Integration (Integration testen) die Meldung Integrationsausführung erfolgreich angezeigt. Klicken Sie zum Ansehen der Logs auf Logs ansehen.
  4. In Antwortparameter wird unter Connector-Ausgabenutzlast die folgende Ausgabe angezeigt:
    [ {
        "employee_id": 1.0,
        "employee_first_name": "Peter",
        "employee_last_name": "Dilliard",
        "employee_emailID": "test-01@test.com"
      },
      {
        "employee_id": 2.0,
        "employee_first_name": "Meaghan",
        "employee_last_name": "Webb",
        "employee_emailID": "test-02@test.com"
      } ]

Weitere Vorgänge für die MySQL-Datenbanktabelle ausführen

Wenn Sie eine Connectors-Aufgabe in der Integration konfigurieren, können Sie einen der folgenden Vorgänge auswählen:

  • Liste
  • Get
  • Erstellen
  • Aktualisieren
  • Löschen

Sie haben den Vorgang „Auflisten“ bereits verwendet, um alle Zeilen in der Tabelle employee anzusehen. In den folgenden Abschnitten dieser Anleitung verwenden Sie die Vorgänge „Abrufen“, „Erstellen“, „Aktualisieren“ und „Löschen“, um Zeilen aus der Tabelle employee hinzuzufügen, zu ändern oder zu entfernen.

Zeile aus einer Tabelle abrufen

Wenn Sie die Entitäts-ID (oder den Primärschlüssel) der Zeile kennen, die Sie abrufen möchten, geben Sie diesen Wert als Eingabe für einen Vorgang „Abrufen“ in Ihrer Integration an. Die vom Vorgang „Abrufen“ zurückgegebenen Details ähneln den vom Vorgang „Auflisten“ zurückgegebenen Details. Der Vorgang „Auflisten“ ruft Details aller Tabellenzeilen ab, die mit der angegebenen Abfrage übereinstimmen. Der Vorgang „Abrufen“ hingegen ruft nur die Details aus der Tabellenzeile ab, die mit der angegebenen Entitäts-ID übereinstimmt.

Beachten Sie, dass der Vorgang „Auflisten“ standardmäßig alle Zeilen in der Tabelle zurückgibt, der Vorgang „Abrufen“ jedoch eine Entitäts-ID als Suchparameter erfordert. Für die Verwendung des Vorgangs „Abrufen“ müssen Sie daher die Entitäts-ID der abzurufenden Zeile kennen oder einen Standardwert für die Entitäts-ID angeben.

Wenn Sie Details zu einer bestimmten Zeile abrufen möchten, führen Sie die folgenden Schritte aus, um die zuvor erstellte Connectors-Aufgabe zu konfigurieren:

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

    Das Dialogfeld Connector-Aufgabe konfigurieren wird angezeigt.

  3. Wählen Sie im Dialogfeld Connector-Aufgabe konfigurieren in der Spalte Vorgang die Option Abrufen aus und klicken Sie dann auf Fertig.
  4. Klicken Sie im Bereich der Aufgabenkonfiguration unter Aufgabeneingabe auf Entitäts-ID.
  5. Wählen Sie im Dialogfeld Variable konfigurieren die Option Als Eingabe für Integration verwenden aus und klicken Sie auf Speichern.
  6. Klicken Sie in der Symbolleiste des Integrationseditors auf die Schaltfläche Test (Testen).
  7. Ändern Sie bei Bedarf den Wert für Ausführungsfrist (in Minuten).
  8. Geben Sie die Entitäts-ID der Entität ein, zur der Sie Details abrufen möchten. Geben Sie 2 ein.
  9. Klicken Sie auf Integration testen.
  10. Sobald die Integration erfolgreich abgeschlossen wurde, wird im Bereich Test Integration (Integration testen) die Meldung Integrationsausführung erfolgreich angezeigt. Klicken Sie zum Ansehen der Logs auf Logs ansehen.
  11. In Antwortparameter wird unter Connector-Ausgabenutzlast die folgende Ausgabe angezeigt:
    [ {
        "employee_id": 2.0,
        "employee_first_name": "Meaghan",
        "employee_last_name": "Webb",
        "employee_emailID": "test-02@test.com"
      } ]
  12. Sie können prüfen, ob die hier angezeigten Informationen mit den Informationen in der entsprechenden Zeile in der MySQL-Tabelle übereinstimmen. Führen Sie den folgenden Befehl über den MySQL-Client aus, um diese Informationen in der MySQL-Tabelle anzusehen:
    SELECT * FROM employee WHERE employee_id=2;
    Die folgende Tabellenzeile wird angezeigt:
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           2 | Meaghan             | Webb               | test-02@test.com |
    +-------------+---------------------+--------------------+------------------+
        

Zeilen zu einer Tabelle hinzufügen

Mit dem Vorgang „Erstellen“ können Sie eine Zeile zu einer Tabelle hinzufügen. Wenn Sie den Vorgang „Erstellen“ verwenden, müssen Sie alle Werte für die Entität in der Connector-Eingabenutzlast angeben.

Zum Hinzufügen einer Zeile mit dem Vorgang „Erstellen“ führen Sie die folgenden Schritte aus, um die zuvor erstellte Connectors-Aufgabe zu konfigurieren.

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

    Das Dialogfeld Connectors-Aufgabe konfigurieren wird angezeigt.

  3. Wählen Sie im Dialogfeld Connector-Aufgabe konfigurieren in der Spalte Vorgang die Option Erstellen aus und klicken Sie dann auf Fertig.
  4. Klicken Sie im Bereich der Aufgabenkonfiguration unter Aufgabeneingabe auf Connector-Eingabenutzlast.
  5. Wählen Sie im Dialogfeld Variable konfigurieren die Option Als Eingabe für Integration verwenden aus und klicken Sie auf Speichern.
  6. Klicken Sie in der Symbolleiste des Integrationseditors auf die Schaltfläche Test (Testen).
  7. Ändern Sie bei Bedarf den Wert für Ausführungsfrist (in Minuten).
  8. Geben Sie die Details für die Entität ein, die Sie erstellen möchten. Wenn Sie beispielsweise einen neuen Mitarbeiter in die Tabelle employee einfügen möchten, geben Sie den folgenden JSON-Code ein:
    {
      "employee_first_name": "Mary",
      "employee_last_name": "Smith",
      "employee_emailID": "test-03@test.com"
    }
  9. Klicken Sie auf Integration testen.
  10. Sobald die Integration erfolgreich abgeschlossen wurde, wird im Bereich Test Integration (Integration testen) die Meldung Integrationsausführung erfolgreich angezeigt. Klicken Sie zum Ansehen der Logs auf Logs ansehen.
  11. In Antwortparameter wird unter Connector-Eingabenutzlast die von Ihnen angegebene Nutzlast angezeigt:
    {
      "employee_first_name": "Mary",
      "employee_last_name": "Smith",
      "employee_emailID": "test-03@test.com"
    }
    Unter Nutzlast der Connector-Ausgabe wird die Entitäts-ID als Ausgabe angezeigt:
    {
      "employee_id": 3.0
    }
  12. Sie können prüfen, ob die Zeile in die MySQL-Tabelle eingefügt wurde. Führen Sie den folgenden Befehl über den MySQL-Client aus, um diese Informationen in der MySQL-Tabelle anzusehen:
    SELECT * FROM employee;
    Die folgenden Tabellenzeilen werden angezeigt:
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | test-01@test.com |
    |           2 | Meaghan             | Webb               | test-02@test.com |
    |           3 | Mary                | Smith              | test-03@test.com |
    +-------------+---------------------+--------------------+------------------+
        

Zeilen in einer Tabelle aktualisieren

Verwenden Sie den Vorgang „Aktualisieren“, um die Werte in einer Tabellenzeile zu ändern. Mit diesem Vorgang können Sie beispielsweise die E-Mail-ID eines Mitarbeiters in der Tabelle employee aktualisieren. Zum Angeben der Entität, die Sie aktualisieren möchten, können Sie die Entitäts-ID angeben, wie auch für den Vorgang „Abrufen“. Alternativ können Sie den Parameter Filterklausel verwenden, um Werte zu übergeben, nach denen die Tabellenzeilen gefiltert werden. Dies ist nützlich, wenn Sie die gleiche Änderung basierend auf bestimmten Suchkriterien in mehreren Zeilen vornehmen möchten.

Führen Sie die folgenden Schritte aus, um die zuvor erstellte Connectors-Aufgabe zu konfigurieren:

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

    Das Dialogfeld Connectors-Aufgabe konfigurieren wird angezeigt.

  3. Wählen Sie im Dialogfeld Connector-Aufgabe konfigurieren in der Spalte Vorgang die Option Aktualisieren aus und klicken Sie dann auf Fertig.
  4. Klicken Sie im Bereich der Aufgabenkonfiguration unter Aufgabeneingabe auf Connector-Eingabenutzlast.
  5. Wählen Sie im Dialogfeld Variable konfigurieren die Option Als Eingabe für Integration verwenden aus und klicken Sie auf Speichern.
  6. Klicken Sie anschließend im Bereich der Aufgabenkonfiguration unter Aufgabeneingabe auf Filterklausel.
  7. Wählen Sie im Dialogfeld Variable konfigurieren die Option Als Eingabe für Integration verwenden aus und klicken Sie auf Speichern.
  8. Klicken Sie in der Symbolleiste des Integrationseditors auf die Schaltfläche Test (Testen).
  9. Ändern Sie bei Bedarf den Wert für Ausführungsfrist (in Minuten).
  10. Geben Sie die Kriterien ein, nach denen Sie filtern möchten. Wenn Sie beispielsweise nach einem Mitarbeiter mit der E-Mail-ID test-03@test.com suchen möchten, geben Sie Folgendes ein:
    employee_emailID="test-03@test.com"
  11. Geben Sie die Werte ein, die Sie aktualisieren möchten. Wenn Sie beispielsweise die E-Mail-ID aller Mitarbeiter in der Tabelle employee aktualisieren möchten, deren aktuelle E-Mail-ID mit der Filterklausel test-03@test.com übereinstimmt, geben Sie den folgenden JSON-Code ein:
    {
      "employee_emailID": "msmith@test.com"
    }
  12. Klicken Sie auf Integration testen.
  13. Sobald die Integration erfolgreich abgeschlossen wurde, wird im Bereich Test Integration (Integration testen) die Meldung Integrationsausführung erfolgreich angezeigt. Rufen Sie mit dem Vorgang „Abrufen“ die Details der angegebenen Entität ab, um zu prüfen, ob die Entität aktualisiert wurde.
  14. Sie können prüfen, ob die Zeile in der MySQL-Tabelle aktualisiert wurde. Führen Sie den folgenden Befehl über den MySQL-Client aus, um diese Informationen in der MySQL-Tabelle anzusehen:
    SELECT * FROM employee;
    Die folgenden Tabellenzeilen werden angezeigt:
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | test-01@test.com |
    |           2 | Meaghan             | Webb               | test-02@test.com |
    |           3 | Mary                | Smith              | msmith@test.com  |
    +-------------+---------------------+--------------------+------------------+
          

Zeile in einer Tabelle löschen

Mit dem Vorgang „Löschen“ können Sie eine oder mehrere Tabellenzeilen löschen. Geben Sie die Entitäts-ID an oder geben Sie mithilfe der Filterklausel die Zeilen an, die Sie löschen möchten. Wenn Sie die Filterklausel zum Angeben von Kriterien für die Zeilen verwenden, die Sie löschen möchten, werden möglicherweise mehrere Zeilen gelöscht, die dem angegebenen Filter entsprechen. Wenn Sie nur eine bestimmte Zeile löschen möchten, verwenden Sie die Entitäts-ID.

Zum Löschen einer Tabellenzeile mithilfe der Entitäts-ID führen Sie die folgenden Schritte aus, um die zuvor erstellte Connectors-Aufgabe zu konfigurieren:

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

    Das Dialogfeld Connector-Aufgabe konfigurieren wird angezeigt.

  3. Wählen Sie im Dialogfeld Connector-Aufgabe konfigurieren in der Spalte Vorgang die Option Löschen aus und klicken Sie dann auf Fertig.
  4. Klicken Sie im Bereich der Aufgabenkonfiguration unter Aufgabeneingabe auf Entitäts-ID.
  5. Wählen Sie im Dialogfeld Variable konfigurieren die Option Als Eingabe für Integration verwenden aus und klicken Sie auf Speichern.
  6. Klicken Sie in der Symbolleiste des Integrationseditors auf die Schaltfläche Test (Testen).
  7. Ändern Sie bei Bedarf den Wert für Ausführungsfrist (in Minuten).
  8. Geben Sie die Entitäts-ID der Tabellenzeile ein, die Sie löschen möchten. Geben Sie 3 ein.
  9. Klicken Sie auf Integration testen.
  10. Wenn die Integration erfolgreich abgeschlossen wurde, wird im Bereich Integration testen die Meldung Integration erfolgreich ausgeführt angezeigt. Prüfen Sie mithilfe des Vorgangs „Abrufen“, ob die Tabellenzeile gelöscht wurde. So rufen Sie die Details der gelöschten Zeile ab. Sie sollten nun einen Fehler für die angegebene Entitäts-ID erhalten.

    Sie können auch den Vorgang „Auflisten“ verwenden und optional eine Filterklausel für die Tabellenzeile (n) angeben, die Sie gelöscht haben. Daraufhin wird die Liste der verbleibenden Zeilen zurückgegeben; dies kann eine leere Liste sein.

    Wenn Sie beispielsweise die Tabellenzeile mit der Entitäts-ID 3 gelöscht haben und die Filterklausel employee_emailID="msmith@test.com" oder die Entitäts-ID 3 für den Vorgang „Auflisten“ angeben, zeigen die Antwortparameter in der Loganzeige [] an.

  11. Sie können prüfen, ob die Zeile in der MySQL-Tabelle gelöscht wurde. Führen Sie den folgenden Befehl über den MySQL-Client aus, um diese Informationen in der MySQL-Tabelle aufzurufen:
    SELECT * FROM employee;
    Die folgenden Tabellenzeilen werden angezeigt:
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | test-01@test.com |
    |           2 | Meaghan             | Webb               | test-02@test.com |
    +-------------+---------------------+--------------------+------------------+
            

Nächste Schritte