#Action SQL

#Introduction

Dans certains scénarios spécifiques, les nœuds d'action de collection simples mentionnés précédemment peuvent ne pas suffire pour des opérations complexes. Dans de tels cas, vous pouvez utiliser directement le nœud SQL pour que la base de données exécute des instructions SQL complexes afin de manipuler les données.

La différence avec une connexion directe à la base de données pour des opérations SQL en dehors de l'application est que, au sein d'un flux de travail, vous pouvez utiliser les variables du contexte du processus comme paramètres dans l'instruction SQL.

#Installation

Plugin intégré, aucune installation n'est requise.

#Créer un nœud

Dans l'interface de configuration du flux de travail, cliquez sur le bouton plus (« + ») dans le flux pour ajouter un nœud « Action SQL » :

#Configuration du nœud

#Source de données

Sélectionnez la source de données sur laquelle exécuter la requête SQL.

La source de données doit être de type base de données, comme la source de données principale, PostgreSQL, ou toute autre source de données compatible avec Sequelize.

#Contenu SQL

Modifiez l'instruction SQL. Actuellement, une seule instruction SQL est prise en charge.

Insérez les variables nécessaires à l'aide du bouton de variable situé dans le coin supérieur droit de l'éditeur. Avant l'exécution, ces variables seront remplacées par leurs valeurs correspondantes via une substitution de texte. Le texte résultant sera ensuite utilisé comme instruction SQL finale et envoyé à la base de données pour exécution.

#Résultat de l'exécution du nœud

Depuis la version v1.3.15-beta, le résultat de l'exécution d'un nœud SQL est un tableau de données pures. Auparavant, il s'agissait de la structure de retour native de Sequelize contenant les métadonnées de la requête (voir : sequelize.query()).

Par exemple, la requête suivante :

select count(id) from posts;

Résultat avant v1.3.15-beta :

[
    [
        { "count": 1 }
    ],
    {
        // meta
    }
]

Résultat après v1.3.15-beta :

[
    { "count": 1 }
]

#Questions fréquentes

#Comment utiliser le résultat d'un nœud SQL ?

Si une instruction SELECT est utilisée, le résultat de la requête sera enregistré dans le nœud au format JSON de Sequelize. Vous pouvez l'analyser et l'utiliser avec le plugin JSON-query.

#L'action SQL déclenche-t-elle des événements de collection ?

Non. L'action SQL envoie directement l'instruction SQL à la base de données pour traitement. Les opérations CREATE / UPDATE / DELETE associées se produisent dans la base de données, tandis que les événements de collection se produisent au niveau de la couche application de Node.js (gérée par l'ORM). Par conséquent, les événements de collection ne seront pas déclenchés.