Exécuter une procédure stockée

Cet exemple montre comment exécuter une procédure stockée lorsque vous utilisez une connexion de base de données. Cet exemple part du principe que vous connaissez les concepts suivants :

Toutes les procédures stockées d'une connexion de base de données vous sont présentées sous forme d'actions dans la tâche du connecteur. Une action est une première qui est mise à la disposition de l'intégration via l'interface du connecteur. Actions vous permettent d'apporter des modifications à une ou plusieurs entités, et varient d'un connecteur à un autre. Toutefois, il est possible qu'un connecteur ne prenne en charge aucune action, auquel cas la liste Actions est vide.

Les connecteurs suivants sont compatibles avec les procédures stockées :

Exemple

Imaginons que vous avez une base de données MySQL contenant la procédure stockée suivante, qui récupère les informations sur le client dans la table customers:

CREATE PROCEDURE get_customer_info
(IN p_customer_id INT, OUT p_name VARCHAR(50), OUT p_email VARCHAR(255))
BEGIN
    SELECT name, email INTO p_name, p_email
    FROM customers
    WHERE id = p_customer_id;
END

Cette procédure stockée renvoie le nom et l'adresse e-mail du client spécifié. Il saisit le numéro client via la variable d'entrée p_customer_id et renvoie le nom et l'adresse e-mail dans les variables de sortie p_name et p_email, respectivement.

Supposons maintenant que vous souhaitiez obtenir le nom et l'ID d'adresse e-mail du client avec customer_id=1001. Pour ce faire, procédez comme suit :

  1. Créez une connexion à votre base de données MySQL.
  2. Ouvrez ou créez une intégration.
  3. Ajoutez la tâche Connecteurs à votre intégration.
  4. Dans la section Configuration, cliquez sur Configurer la tâche pour ouvrir le volet Configurer un connecteur.
  5. Configurez la tâche "Connecteurs" pour utiliser la connexion créée à l'étape 1.
    1. Dans la colonne Connexion, sélectionnez la connexion requise dans la liste des connexions disponibles.

      Une fois que vous avez sélectionné une connexion, la colonne Type s'affiche avec les valeurs Entities et Actions. Toutes les procédures stockées sont répertoriées dans Actions.

    2. Sélectionnez Actions > get_customer_info.
    3. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
  6. Cliquez sur l'élément de tâche Connectors, puis sur connectorInputPayload dans la section Task Input.
  7. Spécifiez la charge utile JSON suivante dans le champ Default Value: 
    {
"customer_id": 1001
}
  8. Cliquez sur le bouton Tester dans la barre d'outils de l'éditeur d'intégrations pour exécuter l'intégration.

    Si l'intégration s'exécute correctement, connectorOutputPayload vairable aura une charge utile JSON semblable à celle-ci:

    {
"name": "John",
"email": "john@test.com"
}