Comment écrire une fonction de connecteur SQL

Comment écrire une fonction de connecteur SQL

Utilisez ce guide pour connecter votre application Tulip à une base de données SQL.

Voici un exemple de la façon d'utiliser les connecteurs de Tulip pour se connecter à une base de données SQL.

Pour ajouter un nouveau connecteur SQL :

1- Allez sur la page Connecteurs en plaçant votre curseur sur Apps dans la barre de menu et en choisissant Connecteurs dans la liste déroulante.

2- Cliquez sur "Add Connector" en haut à droite de l'écran, donnez un nom à votre connecteur et sélectionnez "SQL" comme type de connecteur.

3- Dans l'onglet Environnements du nouveau connecteur, sélectionnez "Add Connection Details".

4- Remplissez les détails appropriés pour vous connecter à la base de données :

• Running On ("Cloud Connector Host" sauf si vous avez configuré un paramètre différent)
• Type
• Serveur
• Port
• SSL (oui ou non)
• Base de données
• Nom d'utilisateur
• Mot de passe

5- Cliquez sur le bouton "Test" pour lancer un signal de test. Si le test est concluant, cliquez sur "Enregistrer".

6- Assurez-vous que l'hôte du connecteur a accès à la base de données (indiqué par l'étiquette verte "Online" à côté du serveur sur la page Connecteurs).

Une fois que vous avez configuré avec succès un nouveau connecteur, vous pouvez maintenant créer des fonctions de connecteur pour envoyer ou récupérer des données à partir de la base de données externe. Une fonction de connecteur doit être écrite dans la langue de la base de données cible.

Pour configurer une nouvelle fonction de connecteur SQL :

1- Cliquez sur le bouton "Ajouter une nouvelle fonction" dans l'onglet Fonctions.

2- Nommez la nouvelle fonction (cela vous permet de sélectionner la fonction de connecteur spécifique dans les Déclencheurs).

1. Configurer les entrées et sorties de la fonction

Dans l'exemple ci-dessus :

Entrées

• configuration (texte)

Sorties

• sous-config_1
• sous-config_2
• sous-config_3

Requête

`SELECT subconfig_1, subconfig_2, subconfig_3 FROM webinar database WHERE configuration = $configuration$ order by id desc limit 1`````

Une fonction peut avoir plusieurs entrées et sorties. Vous aurez besoin d'au moins une entrée ou une sortie pour envoyer/recevoir des données d'une application Tulip.

• Cliquez sur Ajouter pour ajouter une nouvelle entrée ou sortie
• Donnez un nom reconnaissable au champ
• Choisissez le type de données (par exemple Texte, Booléen, Entier, etc.)
• Ajoutez une instruction SQL valide dans le champ Requête. Notez que les noms des variables d'entrée doivent être entourés de $. Exemple :
  $input$.
• Tester la fonction
• Si la fonction a des entrées, saisissez des valeurs valides
• Cliquez sur "Test" en haut à droite.
• Affichez les résultats du test ou les messages d'erreur dans la section Résultats du test.

1. Dans certains cas, vous pouvez souhaiter renvoyer plusieurs lignes d'une table SQL. Pour ce faire, cochez la case située à côté de "Retourner plusieurs lignes". Cela renverra un tableau plein d'objets, où chaque objet contient les valeurs d'une ligne de la table SQL.

Requête

SELECT nom, nombre dans nombres où nombre > $nombre$ (dans l'exemple ci-dessus, nombre est le nom de la personne)

(dans l'exemple ci-dessus, le nombre est une entrée)

Ensuite, lorsque vous ajoutez vos entrées et que vous cliquez sur "Test", vous devriez voir toutes les lignes attendues renvoyées sous "Résultats du test".

Ceux-ci peuvent être stockés dans une Variable comme un tableau plein d'Objets dans l'Editeur de Trigger.

7- Cliquez sur "Enregistrer" lorsque vous avez terminé.

:::(Warning) (NOTE) Les entrées et les sorties ne peuvent pas être modifiées après avoir sauvegardé une fonction. Ceci afin d'éviter de perturber les applications qui pourraient utiliser une fonction de connecteur.
:: :

Si vous devez ajouter de nouvelles entrées/sorties, vous pouvez copier la fonction et apporter des modifications dans la nouvelle fonction.

Pour plus d'informations sur la manière d'écrire certaines fonctions SQL couramment utilisées, reportez-vous à la section"Fonctions de connecteur SQL courantes".

Pour en savoir plus

• Comment utiliser la sortie des fonctions de connecteur dans les applications
• Vue d'ensemble des connecteurs HTTP

Vous avez trouvé ce que vous cherchiez ?

Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres personnes ont répondu à une question similaire !