Connecter n8n à une base de données et exécuter une requête SELECT.

1. Préparer Votre Environnement de Base de Données

Puisque vous avez déjà une instance n8n auto-hébergée, la manière la plus propre et la plus courante d'ajouter une base de données est de l'intégrer à votre configuration Docker. Nous allons ajouter un service MySQL à votre fichier docker-compose.yml.

Si vous préférez utiliser PostgreSQL, la démarche est très similaire. La vidéo How to Build a Local AI Agent With n8n (ressource LINK) montre comment démarrer un conteneur PostgreSQL avec une simple commande docker run (voir de 04:33 à 06:23), et vous pouvez adapter cette logique à votre fichier docker-compose.

Pour cet exercice, nous nous concentrerons sur MySQL.

Instructions pratiques :

1. Localisez votre fichier docker-compose.yml (ou docker-compose.yaml) que vous utilisez pour n8n.

2. Modifiez le fichier pour y ajouter le service mysql, comme montré dans la vidéo. Voici un exemple de ce que vous devez ajouter (adaptez les mots de passe) :

   services:
   
   
   
     # ... votre service n8n existant ...
   
     mysql:
       image: mysql:8.0
       container_name: n8n-mysql
       restart: always
       environment:
         MYSQL_ROOT_PASSWORD: 'VOTRE_MOT_DE_PASSE_ROOT_SECRET'
         MYSQL_DATABASE: 'n8n_db'
         MYSQL_USER: 'n8n_user'
         MYSQL_PASSWORD: 'VOTRE_MOT_DE_PASSE_UTILISATEUR_SECRET'
       ports:
         - '3307:3306' # Mappe le port interne 3306 sur le port 3307 de votre machine hôte
       volumes:
         - mysql_data:/var/lib/mysql
   
   
   
   
   # ... à la fin du fichier, dans la section volumes ...
   volumes:
   
   
   
     # ... votre volume n8n_data existant ...
     mysql_data: {}
   

3. Exécutez les commandes dans votre terminal, à l'emplacement du fichier docker-compose.yml :

   • docker compose down
   • docker compose up -d

Votre instance n8n devrait redémarrer, et un nouveau conteneur n8n-mysql sera créé et lancé à ses côtés. La base de données est prête.

2. Connecter n8n à Votre Base de Données

Maintenant que la base de données est en cours d'exécution, nous devons dire à n8n comment s'y connecter. Cela se fait via la gestion des "Credentials".

Instructions pratiques :

1. Dans votre interface n8n, créez un nouveau workflow.
2. Ajoutez un nœud MySQL.
3. Dans les paramètres du nœud, cliquez sur le champ Credential et sélectionnez Create New.
4. Remplissez le formulaire de connexion en utilisant les informations de votre docker-compose.yml :
   • Host: mysql (ou le nom de votre service Docker si vous l'avez changé).
   • Database: n8n_db
   • User: n8n_user
   • Password: VOTRE_MOT_DE_PASSE_UTILISATEUR_SECRET
   • Port: 3306
5. Cliquez sur Save. n8n testera la connexion. Si tout est correct, vous devriez voir un message de succès.

3. Exécuter une Requête SELECT

La connexion est établie. Il est temps de lire des données. Pour ce faire, nous allons d'abord insérer une donnée de test, puis la récupérer.

Mini-Exercice : Insérer et Sélectionner des Données

Nous allons créer un petit workflow pour peupler notre base et la lire ensuite.

Étape A : Insérer des données de test

Pour que notre SELECT renvoie quelque chose, nous devons d'abord créer une table et y insérer des données.

1. Gardez votre nœud MySQL.

2. Dans les paramètres, choisissez l'opération Execute SQL Query.

3. Dans le champ Query, collez le code SQL suivant pour créer une table customers et y insérer deux clients :

   CREATE TABLE IF NOT EXISTS customers (
       id INT AUTO_INCREMENT PRIMARY KEY,
       name VARCHAR(255),
       email VARCHAR(255)
   );
   
   INSERT INTO customers (name, email)
   VALUES ('Alice Martin', 'alice.martin@example.com'), ('Bob Dupont', 'bob.dupont@example.com')
   ON DUPLICATE KEY UPDATE name=name; -- Pour éviter les erreurs si vous exécutez plusieurs fois
   

4. Cliquez sur Execute Node. La requête s'exécute et vos données sont maintenant dans la base.

Étape B : Sélectionner les données

Maintenant, lisons ces données.

1. Ajoutez un nouveau nœud MySQL (ou modifiez le précédent).
2. Changez l'opération pour Select. C'est une interface simplifiée pour construire des requêtes SELECT sans écrire de SQL.
3. Dans le champ Table, tapez customers.
4. Laissez le champ Columns vide pour tout sélectionner (SELECT *).
5. Cliquez sur Execute Node.

Vous devriez voir en sortie une liste de deux objets JSON, un pour Alice et un pour Bob, représentant les lignes de votre table customers.

Conclusion

Félicitations ! Vous avez franchi une étape cruciale en connectant n8n à une base de données. C'est la porte d'entrée vers des automatisations beaucoup plus sophistiquées.

Points clés à retenir :

• L'intégration d'une base de données à votre environnement n8n auto-hébergé est simple en utilisant Docker Compose.
• La connexion depuis n8n se fait via des Credentials, où le nom d'hôte (host) correspond au nom du service Docker lorsque les deux conteneurs sont dans le même réseau.
• Le nœud de base de données de n8n propose des opérations simplifiées comme Select pour des requêtes courantes, et une option Execute SQL Query pour un contrôle total.

Dans la prochaine leçon, nous irons plus loin avec les bases de données en explorant les opérations d'écriture : INSERT, UPDATE et DELETE. Nous pourrons alors, par exemple, construire un workflow qui reçoit des données via un webhook et les enregistre automatiquement dans notre table customers.