Effectuer des opérations CRUD sur une base de données MySQL

Ce tutoriel explique comment vous connecter à une instance de base de données MySQL à partir d'un exemple d'intégration et comment effectuer des opérations List, Get, Create, Update et Delete sur une table de base de données MySQL.

Pour compléter ce tutoriel, effectuez les tâches suivantes :

Avant de commencer

  • Vérifiez que vous avez accès aux intégrations.
  • Procédez comme suit dans votre projet Google Cloud :

    • Attribuez les rôles suivants au compte de service que vous souhaitez utiliser pour créer la connexion :
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor
    • Activez les services suivants :
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Si ces services n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la création de la connexion sur la page "Créer une connexion".

  • Assurez-vous d'avoir accès à un serveur MySQL permettant de créer une base de données.

Configurer une base de données et une table sur votre serveur MySQL

Connectez-vous à votre serveur MySQL et créez une base de données et une table à utiliser dans ce tutoriel.
  1. Pour vous connecter à votre serveur MySQL, exécutez la commande suivante à partir d'un système sur lequel un client MySQL est installé :
    mysql --host=MySQL server host name or IP address --port=MySQL server port number -uusername -ppassword
    Dans cet exemple, remplacez :
    • MySQL server host name or IP address par le nom ou l'adresse IP de votre serveur MySQL.
    • MySQL server port number par le numéro de port de votre serveur MySQL.
    • username par le nom d'utilisateur de votre serveur MySQL.
    • password par le mot de passe de votre serveur MySQL.
  2. Pour créer la base de données MySQL à utiliser dans ce tutoriel, exécutez la commande suivante à partir de votre client MySQL :
    CREATE DATABASE tutorialDB;
  3. Pour créer la table que vous utiliserez dans ce tutoriel, exécutez la commande suivante à partir de votre client MySQL :
    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. Pour ajouter des lignes à la table employee que vous avez créée, exécutez la commande suivante à partir de votre client MySQL :
    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. Vérifiez que la table a bien été créée et que des lignes ont été ajoutées en exécutant la commande suivante :
    SELECT * FROM employee;
    Les lignes suivantes s'affichent :
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | test-01@test.com |
    |           2 | Meaghan             | Webb               | test-02@test.com |
    +-------------+---------------------+--------------------+------------------+
    

Créer une connexion MySQL

Pour autoriser une intégration à se connecter à votre base de données MySQL, créez une nouvelle connexion à votre base de données MySQL.

  1. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
  2. Dans la section Emplacement, choisissez l'emplacement de la connexion.
    1. Dans la liste Région, sélectionnez la région dans laquelle vous souhaitez créer la connexion.

      Pour obtenir la liste de toutes les régions disponibles, consultez la section Emplacements.

    2. Cliquez sur Suivant.
  3. Dans la section Détails de connexion, saisissez les informations suivantes :
    1. Dans la liste Connecteur, sélectionnez MySQL (bêta).
    2. Dans la liste Version du connecteur, sélectionnez la version du connecteur.
    3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Utilisez des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Les noms ne peuvent pas dépasser 63 caractères.
    4. Facultatif : dans le champ Description, ajoutez une description de l'instance de connexion.
    5. Facultatif : activez Cloud Logging.
    6. Dans la liste Compte de service, sélectionnez un compte de service disposant des rôles requis.
    7. Dans le champ Nom de la base de données, saisissez le nom de la base de données MySQL.
    8. Vous pouvez également configurer les paramètres du nœud de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.

    9. Utiliser un proxy : cochez cette case pour configurer un serveur proxy pour la connexion, et spécifiez les valeurs suivantes :
      • Schéma d'authentification du proxy : sélectionnez le type d'authentification pour l'authentification auprès du serveur proxy. Les types d'authentification suivants sont compatibles :
        • Basique : authentification HTTP de base.
        • Condensé : authentification HTTP par condensé.
      • Utilisateur du proxy : nom d'utilisateur à utiliser pour l'authentification auprès du serveur proxy.
      • Mot de passe du proxy : secret Secret Manager du mot de passe de l'utilisateur.
      • Type SSL du proxy : type SSL à utiliser lors de la connexion au serveur proxy. Les types d'authentification suivants sont compatibles :
        • Auto : paramètre par défaut. Dans le cas d'une URL HTTPS, l'option "Tunnel" est utilisée. Dans le cas d'une URL HTTP, l'option "JAMAIS" est utilisée.
        • Toujours : la connexion SSL est toujours activée.
        • Jamais : la connexion n'est pas activée pour SSL.
        • Tunnel : la connexion s'effectue via un proxy de tunnelisation. Le serveur proxy ouvre une connexion à l'hôte distant et le trafic transite par le proxy.
      • Dans la section Serveur proxy, saisissez les détails du serveur proxy.
        1. Cliquez sur + Ajouter une destination.
        2. Sélectionnez un type de destination.
          • Adresse de l'hôte : spécifiez le nom d'hôte ou l'adresse IP de la destination.

            Si vous souhaitez établir une connexion privée à votre système backend, procédez comme suit :

    10. Facultatif : pour ajouter un libellé à la connexion, cliquez sur + Ajouter un libellé.
    11. Cliquez sur Suivant.
    12. Dans la section Destinations, saisissez les informations concernant l'hôte distant (système backend) auquel vous souhaitez vous connecter.
      • Dans la liste Type de destination, sélectionnez une adresse hôte.
        1. Dans le champ Adresse de l'hôte, spécifiez le nom d'hôte ou l'adresse IP de la destination.
          1. Si vous souhaitez établir une connexion privée à vos systèmes backend, procédez comme suit :
            1. Créez un rattachement de service PSC.
            2. Créez un rattachement de point de terminaison, puis saisissez les détails du rattachement de point de terminaison dans le champ Adresse de l'hôte.
          2. Si vous souhaitez établir une connexion publique à vos systèmes backend avec une sécurité supplémentaire, vous pouvez envisager de configurer des adresses IP sortantes statiques pour vos connexions, puis de configurer vos règles de pare-feu pour ajouter à la liste d'autorisation uniquement les adresses IP statiques spécifiques.

        Pour saisir d'autres destinations, cliquez sur + Ajouter une destination.

      • Cliquez sur Suivant.
    13. Dans la section Authentification, vous pouvez fournir des identifiants :
      • Dans le champ Nom d'utilisateur, saisissez le nom d'utilisateur MySQL pour la connexion.
      • Dans le champ Mot de passe, saisissez le secret Secret Manager contenant le mot de passe associé au nom d'utilisateur MySQL.
        • Si vous avez déjà créé un secret et qu'il n'est pas disponible dans la liste, sélectionnez Saisir le secret manuellement. Dans la boîte de dialogue Ajouter un secret par ID de ressource, copiez et collez l'ID de ressource à partir de Secret Manager.
          • Pour utiliser la dernière version, copiez et collez l'ID de ressource à partir du secret parent, au format suivant : "projects/project-number/secrets/secret-name"
          • Pour sélectionner une version spécifique, copiez et collez l'ID de ressource de cette version spécifique au format "projects/project-number/secrets/secret-name/versions/1".

          Pour ajouter le secret, cliquez sur Ajouter un secret.

        • Si vous n'avez pas créé de secret à utiliser avec MySQL, cliquez sur Nouveau secret. Dans la boîte de dialogue Create Secret (Créer un secret), saisissez les détails suivants :
          • Dans le champ Nom, saisissez le nom du secret.
          • Dans le champ Valeur du secret, saisissez le contenu du secret ou importez un fichier contenant le secret.
          • Cliquez sur Créer un secret.
      • Dans la liste Version du secret, sélectionnez la version du secret mot de passe dans la liste déroulante des versions disponibles.
      • Cliquez sur Suivant.
  4. Dans la section Vérifier, examinez vos informations de connexion et d'authentification.
  5. Cliquez sur Créer.

Configurer l'authentification

Saisissez les détails en fonction de l'authentification que vous souhaitez utiliser.

  • Nom d'utilisateur et mot de passe
    • Nom d'utilisateur : nom d'utilisateur MySQL à utiliser pour la connexion.
    • Mot de passe : secret Secret Manager contenant le mot de passe associé au nom d'utilisateur MySQL.

Configurer une intégration pour utiliser la connexion MySQL

Pour utiliser la connexion MySQL que vous avez créée dans une intégration, ajoutez une tâche Connecteurs dans une intégration avec un déclencheur d'API. Le déclencheur d'API est connecté à la tâche Connecteurs via une connexion Edge.

Créer une intégration

  1. Dans la console Google Cloud, accédez à la page Connecteurs d'intégration.

    Accéder à Integration Connectors

  2. Dans le menu de navigation, cliquez sur Integrations (Intégrations).

    La page Liste des intégrations s'affiche.

  3. Sélectionnez une intégration existante ou créez-en une en cliquant sur CRÉER UNE INTÉGRATION.

    L'intégration s'ouvre dans la page de l'éditeur d'intégrations.

  4. Dans l'éditeur d'intégrations, cliquez sur + Ajouter une tâche/un déclencheur > Tâches pour afficher la liste des tâches disponibles.
  5. Cliquez sur CRÉER.
  6. Saisissez un nom et (éventuellement) une description dans la boîte de dialogue Créer une intégration.
  7. Cliquez sur Créer pour ouvrir l'éditeur d'intégration.

Ajouter et configurer un déclencheur d'API

Pour ajouter et configurer un déclencheur d'API pour l'intégration, procédez comme suit :

  1. Dans l'éditeur d'intégration, sélectionnez Ajouter une tâche/déclencheur > Déclencheurs pour afficher la liste des déclencheurs disponibles.
  2. Faites glisser l'élément Déclencheur d'API vers l'éditeur d'intégration.

Ajouter et configurer une tâche de connecteur

Procédez comme suit pour configurer une tâche Connecteurs afin de lister toutes les entités de la table employee :

  1. Sélectionnez + Ajouter une tâche/un déclencheur > Tâches dans l'éditeur d'intégration pour afficher la liste des tâches disponibles.
  2. Faites glisser l'élément Connecteurs vers l'éditeur d'intégration.
  3. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche.
  4. Cliquez sur Configurer la tâche.

    La boîte de dialogue Configurer la tâche de connecteur s'affiche.

  5. Dans la boîte de dialogue Configurer la tâche de connecteur, procédez comme suit :
    1. Sélectionnez la région de connexion dans laquelle vous avez créé votre connexion MySQL.
    2. Une fois la région choisie, la colonne Connexion s'affiche. Sélectionnez la connexion MySQL que vous avez créée dans la liste des connexions disponibles.
    3. Une fois la connexion sélectionnée, la colonne Type s'affiche. Sélectionnez Entités, puis employé dans la liste des entités disponibles.
    4. Une fois le type choisi, la colonne Opération s'affiche. Sélectionnez Lister.
    5. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer la boîte de dialogue.

Connecter l'élément "Déclencheur d'API" à l'élément de tâche "Connecteurs"

Ensuite, ajoutez une connexion périphérique pour connecter le déclencheur d'API à la tâche "Connecteurs". Une connexion périphérique est une connexion entre deux éléments d'une intégration. Pour plus d'informations sur les périphérie et les conditions périphériques, consultez la section Périphéries.

Pour ajouter la connexion périphérique, cliquez sur le point de contrôle Duplication en bas de l'élément "Déclencheur d'API". Faites glisser la connexion périphérique au niveau du point de contrôle Jointure en haut de l'élément de tâche "Connecteurs".

Tester l'intégration

Pour tester l'intégration, procédez comme suit :

  1. Cliquez sur le bouton Test dans la barre d'outils de l'éditeur d'intégration.
  2. Modifiez la valeur du Délai d'exécution (en minutes) si vous le souhaitez, puis cliquez sur Tester l'intégration.
  3. Une fois l'intégration terminée, le volet Test Integration (Tester l'intégration) affiche le message Integration execution successfully (Exécution de l'intégration réussie). Pour consulter les journaux, cliquez sur Afficher les journaux.
  4. Dans Paramètres de réponse, sous Charge utile de sortie du connecteur, la sortie suivante s'affiche :
    [ {
        "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"
      } ]

Effectuer d'autres opérations sur la table de base de données MySQL

Lorsque vous configurez une tâche "Connecteurs" dans votre intégration, vous pouvez sélectionner l'une des opérations suivantes :

  • List
  • Get
  • Créer
  • Mettre à jour
  • Supprimer

Vous avez déjà utilisé l'opération List pour afficher toutes les lignes de la table employee. Dans les sections suivantes de ce tutoriel, vous allez utiliser les opérations Get, Create, Update et Delete pour ajouter, modifier ou supprimer des lignes de la table employee.

Obtenir une ligne d'une table

Si vous connaissez l'ID d'entité (ou clé primaire) de la ligne que vous souhaitez récupérer, fournissez cette valeur en tant qu'entrée à une opération Get dans votre intégration. Les détails renvoyés par l'opération Get sont semblables à ceux renvoyés par l'opération List. Toutefois, alors que l'opération List récupère les détails de toutes les lignes de la table correspondant à la requête spécifiée, l'opération Get ne récupère les détails que de la ligne de table correspondant à l'ID d'entité spécifié.

N'oubliez pas que, même si l'opération List renvoie par défaut toutes les lignes de la table, l'opération Get nécessite un ID d'entité en tant que paramètre de recherche. Ainsi, pour utiliser l'opération Get, vous devez connaître l'ID de la ligne que vous souhaitez récupérer ou fournir une valeur par défaut pour l'ID d'entité.

Pour obtenir les détails d'une ligne spécifiée, procédez comme suit pour configurer la tâche Connectors que vous avez créée précédemment :

  1. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche.
  2. Cliquez sur Configurer la tâche.

    La boîte de dialogue Configurer la tâche de connecteur s'affiche.

  3. Dans la boîte de dialogue Configurer la tâche de connecteur, dans la colonne Opération, sélectionnez Get, puis cliquez sur Terminé.
  4. Dans le volet de configuration de la tâche, sous Entrée de la tâche, cliquez sur ID d'entité.
  5. Dans la boîte de dialogue Configurer la variable, sélectionnez Utiliser comme entrée pour l'intégration, puis cliquez sur Enregistrer.
  6. Cliquez sur le bouton Test dans la barre d'outils de l'éditeur d'intégration.
  7. Si vous le souhaitez, modifiez la valeur du Délai d'exécution (en minutes).
  8. Saisissez l'ID d'entité de l'entité pour laquelle vous souhaitez récupérer les détails. Saisissez 2.
  9. Cliquez sur Tester l'intégration.
  10. Une fois l'intégration terminée, le volet Test Integration (Tester l'intégration) affiche le message Integration execution successfully (Exécution de l'intégration réussie). Pour consulter les journaux, cliquez sur Afficher les journaux.
  11. Dans Paramètres de réponse, sous Charge utile de sortie du connecteur, la sortie suivante s'affiche :
    [ {
        "employee_id": 2.0,
        "employee_first_name": "Meaghan",
        "employee_last_name": "Webb",
        "employee_emailID": "test-02@test.com"
      } ]
  12. Vous pouvez vérifier que les informations affichées ici coïncident avec les informations de la ligne correspondante dans votre table MySQL. Pour afficher ces informations dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL :
    SELECT * FROM employee WHERE employee_id=2;
    La ligne de table suivante s'affiche :
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           2 | Meaghan             | Webb               | test-02@test.com |
    +-------------+---------------------+--------------------+------------------+
        

Ajouter une ligne à une table

L'opération Create vous permet d'ajouter une ligne dans une table. Lorsque vous utilisez l'opération Create, vous devez fournir toutes les valeurs de l'entité dans la charge utile d'entrée du connecteur.

Pour ajouter une ligne à l'aide de l'opération Create, procédez comme suit pour configurer la tâche Connectors que vous avez créée précédemment :

  1. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche.
  2. Cliquez sur Configurer la tâche.

    La boîte de dialogue Configurer la tâche de connecteur s'affiche.

  3. Dans la boîte de dialogue Configurer la tâche de connecteur, dans la colonne Opération, sélectionnez Create, puis cliquez sur Terminé.
  4. Dans le volet de configuration de la tâche, sous Entrée de la tâche, cliquez sur Charge utile d'entrée du connecteur.
  5. Dans la boîte de dialogue Configurer la variable, sélectionnez Utiliser comme entrée pour l'intégration, puis cliquez sur Enregistrer.
  6. Cliquez sur le bouton Test dans la barre d'outils de l'éditeur d'intégration.
  7. Si vous le souhaitez, modifiez la valeur du Délai d'exécution (en minutes).
  8. Saisissez les détails de l'entité que vous souhaitez créer. Par exemple, pour ajouter un nouvel employé dans la table employee, saisissez le code JSON suivant :
    {
      "employee_first_name": "Mary",
      "employee_last_name": "Smith",
      "employee_emailID": "test-03@test.com"
    }
  9. Cliquez sur Tester l'intégration.
  10. Une fois l'intégration terminée, le volet Test Integration (Tester l'intégration) affiche le message Integration execution successfully (Exécution de l'intégration réussie). Pour consulter les journaux, cliquez sur Afficher les journaux.
  11. Dans Paramètres de réponse, sous Charge utile d'entrée du connecteur, la charge utile que vous avez fournie s'affiche :
    {
      "employee_first_name": "Mary",
      "employee_last_name": "Smith",
      "employee_emailID": "test-03@test.com"
    }
    Sous Charge utile de sortie du connecteur, l'ID d'entité s'affiche en tant que sortie :
    {
      "employee_id": 3.0
    }
  12. Vous pouvez vérifier que la ligne est ajoutée dans votre table MySQL. Pour afficher ces informations dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL :
    SELECT * FROM employee;
    Les lignes de table suivantes sont affichées :
    +-------------+---------------------+--------------------+------------------+
    | 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 |
    +-------------+---------------------+--------------------+------------------+
        

Mettre à jour une ligne dans une table

Utilisez l'opération Update pour modifier les valeurs d'une ligne de table. Par exemple, vous pouvez utiliser cette opération pour mettre à jour l'ID d'adresse e-mail d'un employé dans la table employee. Pour spécifier l'entité que vous souhaitez mettre à jour, vous pouvez fournir l'ID d'entité comme vous l'avez fait pour l'opération Get. Vous pouvez également utiliser le paramètre Clause de filtre pour transmettre les valeurs qui seront utilisées pour filtrer les lignes de la table. Cette méthode est utile si vous souhaitez apporter la même modification sur plusieurs lignes en fonction de critères de recherche spécifiques.

Pour mettre à jour une ligne de table, procédez comme suit pour configurer la tâche Connectors que vous avez créée précédemment :

  1. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche.
  2. Cliquez sur Configurer la tâche.

    La boîte de dialogue Configurer la tâche de connecteur s'affiche.

  3. Dans la boîte de dialogue Configurer la tâche de connecteur, dans la colonne Opération, sélectionnez Update, puis cliquez sur Terminé.
  4. Dans le volet de configuration de la tâche, sous Entrée de la tâche, cliquez sur Charge utile d'entrée du connecteur.
  5. Dans la boîte de dialogue Configurer la variable, sélectionnez Utiliser comme entrée pour l'intégration, puis cliquez sur Enregistrer.
  6. Ensuite, dans le volet de configuration de la tâche, sous Entrée de la tâche, cliquez sur Clause de filtre.
  7. Dans la boîte de dialogue Configurer la variable, sélectionnez Utiliser comme entrée pour l'intégration, puis cliquez sur Enregistrer.
  8. Cliquez sur le bouton Test dans la barre d'outils de l'éditeur d'intégration.
  9. Si vous le souhaitez, modifiez la valeur du Délai d'exécution (en minutes).
  10. Saisissez les critères de filtrage. Par exemple, pour rechercher un employé avec l'ID d'adresse e-mail test-03@test.com, saisissez :
    employee_emailID="test-03@test.com"
  11. Saisissez les valeurs à mettre à jour. Par exemple, pour mettre à jour l'ID e-mail de tous les employés de la table employee dont l'ID e-mail actuel correspond à la clause de filtre test-03@test.com, saisissez le JSON suivant :
    {
      "employee_emailID": "msmith@test.com"
    }
  12. Cliquez sur Tester l'intégration.
  13. Une fois l'intégration terminée, le volet Test Integration (Tester l'intégration) affiche le message Integration execution successfully (Exécution de l'intégration réussie). Pour vérifier que l'entité a bien été mise à jour, utilisez l'opération Get pour obtenir les détails de l'entité spécifiée.
  14. Vous pouvez vérifier que la ligne est mise à jour dans votre table MySQL. Pour afficher ces informations dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL :
    SELECT * FROM employee;
    Les lignes de table suivantes sont affichées :
    +-------------+---------------------+--------------------+------------------+
    | 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  |
    +-------------+---------------------+--------------------+------------------+
          

Supprimer une ligne dans une table

Vous pouvez utiliser l'opération Delete pour supprimer une ou plusieurs lignes d'une table. Fournissez l'ID d'entité ou utilisez la clause de filtrage pour spécifier les lignes que vous souhaitez supprimer. N'oubliez pas que si vous utilisez la clause de filtrage pour spécifier des critères vis-à-vis des lignes à supprimer, il est possible de supprimer plusieurs lignes correspondant au filtre donné. Si vous souhaitez supprimer une seule ligne spécifique, utilisez l'ID d'entité.

Pour supprimer une ligne de table à l'aide de l'ID d'entité, procédez comme suit pour configurer la tâche Connecteurs que vous avez créée précédemment :

  1. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche.
  2. Cliquez sur Configurer la tâche.

    La boîte de dialogue Configurer la tâche de connecteur s'affiche.

  3. Dans la boîte de dialogue Configurer la tâche de connecteur, dans la colonne Opération, sélectionnez Delete, puis cliquez sur Terminé.
  4. Dans le volet de configuration de la tâche, sous Entrée de la tâche, cliquez sur ID d'entité.
  5. Dans la boîte de dialogue Configurer la variable, sélectionnez Utiliser comme entrée pour l'intégration, puis cliquez sur Enregistrer.
  6. Cliquez sur le bouton Test dans la barre d'outils de l'éditeur d'intégration.
  7. Si vous le souhaitez, modifiez la valeur du Délai d'exécution (en minutes).
  8. Saisissez l'ID d'entité de la ligne de table que vous souhaitez supprimer. Saisissez 3.
  9. Cliquez sur Tester l'intégration.
  10. Une fois l'intégration terminée, le volet Test Integration (Tester l'intégration) affiche le message Integration execution successfully (Exécution de l'intégration réussie). Pour vérifier que la ligne de la table a bien été supprimée, utilisez l'opération Get pour obtenir les détails de la ligne que vous avez supprimée. Cette erreur devrait renvoyer une erreur pour l'ID d'entité spécifié.

    Vous pouvez également utiliser l'opération List et éventuellement fournir une clause de filtrage pour la ou les lignes de table que vous avez supprimées. Cette fonction renvoie la liste des lignes restantes, qui peut être vide.

    Par exemple, si vous avez supprimé la ligne de table avec l'ID d'entité 3, si vous spécifiez la clause de filtrage employee_emailID="msmith@test.com" ou l'ID d'entité 3 pour l'opération List, les paramètres de réponse dans les journaux affichent [].

  11. Vous pouvez vérifier que la ligne est supprimée dans votre table MySQL. Pour vérifier cela dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL :
    SELECT * FROM employee;
    . Les lignes de table suivantes sont affichées :
    +-------------+---------------------+--------------------+------------------+
    | employee_id | employee_first_name | employee_last_name | employee_emailID |
    +-------------+---------------------+--------------------+------------------+
    |           1 | Peter               | Dilliard           | test-01@test.com |
    |           2 | Meaghan             | Webb               | test-02@test.com |
    +-------------+---------------------+--------------------+------------------+
            

Étapes suivantes