Ressources · Intégration n8n

Intégration TimescaleDB n8nAutomatiser TimescaleDB avec n8n.

Tes mesures s'empilent dans TimescaleDB et ton automatisation doit les lire et les écrire sans script maison. L'intégration TimescaleDB n8n ouvre une connexion directe à la base et donne 3 opérations : exécuter du SQL, insérer des lignes, en mettre à jour. Aucun trigger fourni, un autre nœud lance la partie.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

L'intégration TimescaleDB n8n, elle sert à quoi au juste ?

Le nœud TimescaleDB se comporte comme un client de base posé au milieu du workflow, c'est-à-dire de la suite de nœuds qui s'exécutent l'un après l'autre. Il se connecte avec un hôte, un nom de base, un utilisateur et un mot de passe, puis parle SQL à l'instance. Trois opérations, pas une de plus : Execute Query pour toute requête que tu écris, Insert pour ajouter des lignes, Update pour modifier celles qui existent déjà.

Commençons par ce qui surprend les habitués des autres intégrations. Ici, le credential ouvre une connexion à une base de données, avec un hôte, un port et un nom de base. Ce n'est pas une API web. Le réflexe habituel, celui d'aller chercher le nœud HTTP Request quand une opération manque, ne marche donc pas sur cette page. Le vrai recours s'appelle Execute Query : il accepte n'importe quelle requête SQL, donc tout ce que Insert et Update ne couvrent pas s'écrit à la main dans ce champ.

Le cas le plus courant reste la lecture régulière. Une requête d'agrégation tourne à heure fixe, les lignes reviennent sous forme d'items, et le nœud suivant s'en sert. Le résultat part dans un tableau via Google Sheets pour que l'équipe le consulte sans client SQL, ou sert de seuil d'alerte. Avantage secondaire : la requête reste visible dans le workflow, donc lisible par celui qui reprend le sujet six mois plus tard.

Vient ensuite l'écriture. Un workflow interroge une source, met en forme la charge utile, et Insert dépose une ligne par item dans la table nommée. Le template public 917 montre le montage minimal : un nœud HTTP Request récupère la position de la Station spatiale internationale, le nœud TimescaleDB la range. Change la source et le schéma tient pour des relevés de capteurs, des compteurs d'API ou des points de prix.

Troisième usage, la correction. Un capteur change de nom, un lot a reçu la mauvaise étiquette, un statut doit évoluer. Update prend la table et une Update Key, la colonne qui désigne les lignes concernées, et ne réécrit que les colonnes listées. Rien à voir avec une suppression, les lignes restent en place.

Deux limites à connaître avant de câbler. Pas de nœud trigger TimescaleDB : rien ne surveille la base, le départ vient d'un Schedule Trigger à intervalle fixe, d'un Webhook n8n appelé par un service tiers ou du trigger d'un autre outil. Et un champ marqué requis laissé vide bloque l'exécution du nœud. Pour le reste, les habitudes prises sur Postgres se transposent directement. L'Avis n8n détaille le volet hébergement et licence, et la Formation n8n reprend les bases des expressions.

Connexion

Comment connecter TimescaleDB à n8n ?

  1. 01

    Créer le credential une bonne fois

    Dans n8n, menu Credentials, choisis TimescaleDB. Un credential, c'est un jeu d'identifiants enregistré une seule fois puis proposé dans la liste déroulante de chaque nœud TimescaleDB que tu ajoutes ensuite. Une seule méthode d'authentification existe pour cet outil : la connexion à la base de données. Pas d'écran OAuth, pas de clé d'API à faire tourner. Il te faut d'abord une instance TimescaleDB disponible.

  2. 02

    Renseigner les coordonnées de l'instance

    Cinq valeurs viennent de ton serveur : le Host, nom de serveur complet ou adresse IP de ton serveur TimescaleDB, la Database à laquelle se connecter, le User avec lequel ouvrir la session, le Password de cet utilisateur et le Port, qui correspond au port d'écoute du serveur. Ces réglages sont ceux de ton instance, n8n ne les génère pas.

  3. 03

    Choisir le comportement SSL

    Le sélecteur SSL pilote le ssl-mode de la chaîne de connexion. Require est la valeur par défaut des chaînes de connexion TimescaleDB : seule une connexion chiffrée est tentée, et si un fichier d'autorité de certification racine est présent, n8n vérifie que le certificat du serveur vient bien d'une autorité de confiance. Allow essaie d'abord sans SSL puis bascule en SSL. Disable ne tente qu'une connexion non chiffrée.

Actions

Ce que le nœud TimescaleDB sait faire

Le nœud TimescaleDB expose 3 opérations. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

01

Execute a SQL query

executeQuery

Ce que tu vois dans n8n

Notes & cas d'usage

Cette opération envoie la requête que tu écris et renvoie son résultat. Un SELECT ressort en items, une instruction d'écriture s'exécute.

Paramètres clés

  • Query : la requête à exécuter, obligatoire. Elle accepte les expressions n8n, de la forme {{ $json.field }}, ou les repères $1 et $2, à utiliser avec les paramètres de requête.
  • Query Parameters : dans Additional Fields, la liste des propriétés servant de paramètres de requête, séparées par des virgules, du type quantity,price.
  • Mode : la façon d'envoyer les requêtes à la base, dans Additional Fields. multiple par défaut en envoie plusieurs d'un coup, independently les exécute séparément, transaction les passe dans une seule transaction.
Cas d'usage
le calcul du volume traité la veille, dont le résultat alimente un message de suivi.
02

Insert rows in database

insert

Ce que tu vois dans n8n

Notes & cas d'usage

Les items qui arrivent deviennent des lignes neuves dans la table visée, sans écrire l'instruction INSERT.

Paramètres clés

  • Schema : obligatoire, le nom du schéma auquel la table appartient.
  • Table : obligatoire, le nom de la table dans laquelle insérer les données.
  • Columns : la liste des propriétés à utiliser comme colonnes des nouvelles lignes, séparées par des virgules, par exemple id,name,description. Tu peux préciser le type d'une colonne en lui ajoutant :type : id:int,name:text donne int à id et text à name.
  • Return Fields : la liste, séparée par des virgules, des champs que l'opération renvoie.
Cas d'usage
archiver chaque relevé collecté par un workflow de collecte, comme le template 917 le fait avec la position de la Station spatiale internationale.
03

Update rows in database

update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifier l'existant plutôt qu'empiler du neuf : le nœud repère les lignes sur une colonne et réécrit celles que tu désignes.

Paramètres clés

  • Update Key : obligatoire, le nom de la propriété qui décide quelles lignes de la base sont mises à jour. En temps normal, ce sera id.
  • Schema et Table : obligatoires tous les deux, le schéma auquel la table appartient et la table dans laquelle mettre à jour les données.
  • Columns : la liste des propriétés à utiliser comme colonnes des lignes à modifier, séparées par des virgules, du type name,description.
  • Return Fields : la liste, séparée par des virgules, des champs que l'opération renvoie.
Cas d'usage
propager le nouveau libellé d'un équipement sur ses lignes historiques après un renommage dans l'inventaire.
Besoin d'aide

Besoin d'aide pour automatiser TimescaleDB avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

TimescaleDB et n8n : les questions fréquentes

01L'intégration TimescaleDB n8n est-elle gratuite ?
Côté n8n, oui. Le nœud TimescaleDB est livré avec n8n : rien à installer, aucun coût supplémentaire pour le débloquer. Le comportement est le même sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans retouche. Ce que coûte ton instance TimescaleDB elle-même dépend de la façon dont tu l'exploites, et cette page ne traite pas ce sujet.
02Quels identifiants faut-il pour le nœud TimescaleDB ?
Un seul type de credential, la connexion à la base de données. Ni OAuth, ni clé d'API. Tu fournis le Host, nom de serveur complet ou adresse IP de ton serveur TimescaleDB, la Database à laquelle te connecter, le User pour ouvrir la session, le Password de cet utilisateur et le Port d'écoute du serveur. Deux réglages complètent le tableau côté chiffrement : le sélecteur SSL, qui fixe le ssl-mode à allow, disable ou require, et Ignore SSL Issues, qui laisse n8n se connecter même quand la validation du certificat échoue. Le credential se crée une fois dans le menu Credentials, chaque nœud le retrouve ensuite dans sa liste.
03Quelles sont les limites du nœud TimescaleDB dans n8n ?
Le nœud expose 3 opérations sur une ressource unique : Execute Query, Insert et Update. Surface volontairement étroite, avec une porte de sortie qui n'est pas celle qu'on attend. Comme le credential ouvre une connexion à une base et non une API web, le nœud HTTP Request ne sert à rien ici. C'est Execute Query qui joue ce rôle : il prend n'importe quelle requête SQL, donc tout ce que les deux opérations d'écriture ne couvrent pas se rédige à la main. Dernier point : un champ marqué requis laissé vide empêche le nœud de s'exécuter.
04Le nœud TimescaleDB réagit-il en temps réel ?
Non, il ne réagit pas de lui-même. TimescaleDB n'a pas de nœud trigger dans n8n, donc rien ne surveille l'arrivée de nouvelles lignes. Un workflow qui touche à TimescaleDB démarre ailleurs : un Schedule Trigger qui se déclenche à intervalle fixe, un Webhook n8n, c'est-à-dire une adresse que tu donnes à un service tiers pour qu'il appelle ton workflow quand un événement se produit chez lui, ou le trigger d'un autre outil déjà en place. Une fois ce premier nœud parti, l'opération TimescaleDB s'exécute dans la même exécution.
05n8n ou Make pour TimescaleDB ?
Ça dépend d'où tu veux placer tes données et ton budget. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : un workflow qui insère des milliers de mesures consomme ce budget au fil de l'eau. n8n s'auto-héberge avec Docker ou npm, ce qui garde le trafic vers la base dans ton propre réseau, ou s'utilise sur n8n Cloud si personne chez toi ne veut gérer de serveur. Les deux proposent une logique visuelle sur un canevas. Tranche sur l'hébergement, la maîtrise des données, le modèle de coût et le canevas que ton équipe lit le plus vite.