- Accueil
- Ressources
- Intégrations
- Postgres
Intégration Postgres n8nAutomatiser Postgres avec n8n.
Les lignes que tes workflows réclament dorment déjà dans Postgres. L'intégration Postgres n8n couvre 6 opérations sur une ressource Database, du Select filtré à la requête SQL brute, plus un trigger qui démarre un workflow sur 3 événements de table. Pour les équipes qui écrivent déjà du SQL.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que couvre vraiment l'intégration Postgres n8n ?
n8n livre deux nœuds pour PostgreSQL. Le nœud Postgres lit et écrit des lignes via 6 opérations regroupées sur une ressource Database unique, et le Postgres Trigger démarre un workflow quand une table bouge. Les deux partagent le même credential Postgres, c'est-à-dire la connexion enregistrée une fois dans le menu Credentials et réutilisée par tous les workflows de l'instance.
Premier cas, la base prévient toute seule. Le Postgres Trigger surveille la table des commandes, le workflow part sur INSERT, un database.select récupère la ligne client associée et le récapitulatif arrive dans Gmail pour l'équipe atelier. Personne ne rafraîchit un écran d'administration pour savoir qu'une commande est tombée.
Deuxième cas, le reporting du mois. Le cabinet comptable veut son tableau, alors un workflow programmé lance un database.select trié, écrit le résultat dans Google Sheets, puis marque les lignes exportées avec database.update pour que le passage suivant les ignore.
Troisième cas, la synchro de nuit. Les lignes viennent d'un autre système, souvent Mysql, et database.upsert les écrit en une passe : il insère celles qui manquent, il met à jour celles qui existent déjà. Relancer deux fois le même workflow ne crée pas de doublon.
Cinq opérations sur six mappent les colonnes à ta place, ce qui suffit la plupart du temps. Dès qu'il faut une jointure, un agrégat ou une fonction de fenêtrage, database.executeQuery prend le SQL tel quel. Une expression n8n va chercher un champ de l'item entrant, sous la forme {{ $json.champ }}, donc la même requête change d'une exécution à l'autre. L'option Query Parameters compte ici : les valeurs listées se rappellent dans la requête sous la forme $1, $2, $3, et n8n les assainit, ce que l'aide du nœud recommande contre l'injection SQL.
Deux comportements méritent un coup d'œil avant de construire. Les colonnes de type date reviennent en chaînes datetime ISO 8601, parce que n8n lit Postgres via le paquet pg : une date stockée peut donc arriver avec une heure et un fuseau. Le contournement documenté, c'est TO_CHAR au moment de la requête. Quant à Select, il ne ramène toute la table que si Return All est activé, sinon Limit plafonne le résultat.
Si le choix de la plateforme reste ouvert, l'Avis n8n détaille les arbitrages face aux alternatives hébergées, et la Formation n8n couvre la construction de ces workflows de bout en bout.
Comment connecter Postgres à n8n ?
- 01
Créer d'abord le compte de connexion
Le credential s'appuie sur un compte utilisateur qui existe déjà sur le serveur Postgres, donc crée-le avant d'ouvrir n8n. Le nœud ne propose qu'une méthode d'authentification, Database connection : pas d'écran OAuth, pas de jeton à renouveler. Donne à ce compte les droits dont le workflow a besoin et rien de plus, puisque chaque opération du nœud s'exécute sous son identité.
- 02
Remplir le credential Postgres
Cinq champs décrivent la connexion : Host, Database, User, Password et Port. Si l'hôte ou le port n'est pas clair, la commande
/conninforenvoie les deux, tout comme les requêtesSELECT inet_server_addr();etSELECT inet_server_port();lancées depuis une session sur le serveur. - 03
Choisir le chemin de la connexion
SSL prend trois valeurs : Allow essaie d'abord sans chiffrement puis bascule en SSL, Disable reste en clair, Require n'accepte que le SSL et vérifie le certificat du serveur face au fichier de CA racine présent. Ignore SSL Issues connecte même si la validation échoue. SSH Tunnel encapsule la session dans SSH, par mot de passe ou Private Key et Passphrase.
Qu'est-ce qui déclenche un workflow depuis Postgres ?
Postgres Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Postgres. Il couvre 3 événements, listés ci-dessous par famille. Tu actives le workflow et chaque événement reçu devient une exécution.
Ce que tu vois dans n8n
Tous les événements, par famille
Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.
DELETE.*1DELETE.DELETE
INSERT.*1INSERT.INSERT
UPDATE.*1UPDATE.UPDATE
Notes de configuration
01Postgres Trigger setup
Le Postgres Trigger, version 1, lance un workflow quand une table bouge. Deux modes d'écoute cohabitent dans le même nœud, et les paramètres changent selon le mode choisi.
Paramètres clés
- Listen For : Listen and Create Trigger Rule surveille une table, Listen to Channel surveille un canal nommé.
- Schema Name et Table Name : les deux sont requis, à choisir dans une liste ou à saisir au nom.
- Channel Name : requis en mode canal, c'est le nom du canal que le nœud surveille.
- Event to listen for : Insert, Update ou Delete, les 3 événements gérés par ce nœud.
- Additional Fields : Trigger Name, Function Name et Replace if Exists nomment les objets créés par n8n et l'autorisent à écraser une paire existante.
02Insert events
Coche Insert dans Event to listen for et le workflow démarre à chaque ligne ajoutée dans la table surveillée. INSERT reste l'événement par lequel commencent la plupart des automatisations Postgres.
Paramètres clés
- Table Name : un nœud trigger écoute une seule table, donc la table des inscriptions et celle des commandes demandent chacune la leur.
- Connection Timeout : dans Options, le nombre de secondes réservées à la connexion à la base, à augmenter sur un serveur distant.
database.select quand le workflow a besoin des valeurs de la ligne et pas seulement de son apparition. Sur une table qui reçoit des imports en masse, cette combinaison garde aussi le workflow lisible.03Update events
Update réagit à UPDATE sur la table surveillée, quelle que soit la colonne modifiée. Décider si le changement mérite une action se fait plus loin dans le workflow, pas dans le trigger.
Paramètres clés
- Schema Name : vise le schéma qui contient réellement la table, pas le schéma par défaut par habitude.
- Delay Closing Idle Connection : le nombre de secondes d'attente avant qu'une connexion inactive devienne éligible à la fermeture.
04Delete events
DELETE est l'événement que rien d'autre ne peut te raconter, puisque la ligne a quitté la table au moment où quelqu'un vient la chercher.
Paramètres clés
- Function Name : nomme la procédure créée par n8n pour signaler l'événement, pratique quand plusieurs workflows surveillent le même schéma.
- Replace if Exists : dans Additional Fields, remplace une fonction et un trigger portant déjà le même nom au lieu d'échouer à la publication suivante.
Ce que le nœud Postgres sait faire, opération par opération
Le nœud Postgres expose 6 opérations sur 1 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | Update | Delete | Execute Query | Insert | Select | Insert or Update |
|---|---|---|---|---|---|---|
| Database | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Sommaire des opérations
Database
6 opérationsDelete table or rows
database.deleteTableCe que tu vois dans n8n
Notes & cas d'usage
Delete efface des données dans une table. Selon la commande choisie, il emporte aussi la table elle-même, sa structure comprise. Un seul paramètre tranche.
Paramètres clés
- Command : Truncate vide la table et conserve sa structure, Delete supprime les lignes qui répondent aux conditions, Drop supprime les données et la structure définitivement.
- Select Rows : une Column, un Operator et une Value ; sans rien de défini, toutes les lignes de la table sont sélectionnées.
- Restart Sequences : remet les colonnes d'identité à leur valeur initiale pendant un Truncate.
Execute a SQL query
database.executeQueryCe que tu vois dans n8n
Notes & cas d'usage
Execute Query envoie le SQL au serveur tel qu'il est écrit et renvoie ce que la requête produit, jointures et agrégats compris.
Paramètres clés
- Query : requis, accepte les expressions n8n et les jetons
$1,$2,$3qui pointent vers les valeurs définies dans Query Parameters. - Query Parameters : une liste de valeurs séparées par des virgules, que n8n assainit, recommandée par l'aide du nœud contre l'injection SQL.
- Treat query parameters in single quotes as text : lit
'$1'comme du texte et non comme un emplacement.
Insert rows in a table
database.insertCe que tu vois dans n8n
Notes & cas d'usage
Insert ajoute des lignes dans une table à partir des items qui entrent dans le nœud, une ligne par item.
Paramètres clés
- Columns : requis, et c'est le mode de mapping qui fait le travail. Map Each Column Manually fixe une valeur par colonne, Map Automatically fait correspondre les noms des champs entrants aux noms des colonnes.
- Skip on Conflict : dans Options, ignore la ligne au lieu de lever une erreur quand une contrainte d'unicité ou d'exclusion est violée.
- Replace Empty Strings with NULL : utile quand la donnée sort d'un tableur.
Insert or update rows in a table
database.upsertCe que tu vois dans n8n
Notes & cas d'usage
Insert or Update écrit un lot de lignes en une passe. Il insère celles que la table n'a pas encore et met à jour celles qui existent, ce qui rend une seconde exécution inoffensive.
Paramètres clés
- Columns : requis, avec les deux mêmes modes de mapping qu'Insert, Map Each Column Manually et Map Automatically.
- Query Batching : Single Query envoie une seule requête pour tous les items, Independent exécute une requête par item, Transaction annule tout si une requête échoue.
Select rows from a table
database.selectCe que tu vois dans n8n
Notes & cas d'usage
Select lit des lignes sans que personne écrive de SQL. Conditions, tri et liste des colonnes de sortie se règlent dans le panneau du nœud.
Paramètres clés
- Return All : activé, n8n enchaîne toutes les pages de résultats ; désactivé, Limit plafonne le nombre de lignes renvoyées.
- Select Rows : Column, Operator et Value, avec des opérateurs qui vont d'Equal et Not Equal à Like, Is Null et Is Not Null.
- Sort : une colonne et une Direction, ASC ou DESC.
- Output Columns : ne garde que les colonnes que la suite du workflow lit vraiment.
Update rows in a table
database.updateCe que tu vois dans n8n
Notes & cas d'usage
Update modifie des lignes qui existent déjà, en prenant les nouvelles valeurs dans les items qui entrent.
Paramètres clés
- Columns : requis. Map Automatically ne marche que si les noms des champs entrants correspondent aux noms des colonnes, donc un nœud Edit Fields placé avant fait souvent le renommage.
- Output Large-Format Numbers As : Numbers par défaut, Text pour les colonnes NUMERIC et BIGINT qui dépassent 16 chiffres.
Besoin d'aide pour automatiser Postgres avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


