INTÉGRATION TIMESCALEDB n8n : AUTOMATISER TIMESCALEDB AVEC N8N

L'action Execute Query est votre couteau suisse pour interagir avec TimescaleDB. Elle vous permet d'exécuter n'importe quelle requête SQL directement depuis votre workflow n8n, offrant une flexibilité totale pour les opérations complexes qui dépassent les actions standard.

Paramètres de configuration :

• Credential to connect with : sélectionnez votre credential TimescaleDB dans ce menu déroulant. Ce paramètre est requis pour établir la connexion à votre base de données.
• Operation : menu déroulant requis définissant l'action à effectuer. Sélectionnez "Execute Query" pour activer cette fonctionnalité.
• Query : zone de texte requise où vous saisissez votre requête SQL. Vous pouvez y écrire des SELECT, INSERT, UPDATE, DELETE, ou même des requêtes spécifiques à TimescaleDB comme des agrégations time_bucket.
• Additional Fields : section optionnelle permettant d'ajouter des propriétés supplémentaires pour des configurations avancées.

Cas d'usage typiques :

• Exécuter des requêtes d'agrégation time_bucket pour calculer des moyennes horaires ou journalières de vos métriques
• Lancer des requêtes de nettoyage pour supprimer les données obsolètes selon votre politique de rétention
• Effectuer des jointures complexes entre plusieurs tables pour enrichir vos données avant export
• Créer des vues matérialisées ou rafraîchir des continuous aggregates

Cette action est particulièrement utile quand les actions Insert et Update standard ne couvrent pas vos besoins spécifiques, ou lorsque vous devez exécuter des requêtes de lecture complexes.

L'action Insert vous permet d'ajouter de nouveaux enregistrements dans vos tables TimescaleDB. C'est l'action idéale pour l'ingestion de données en temps réel depuis des sources externes vers vos hypertables.

Paramètres de configuration :

• Credential to connect with : menu déroulant requis pour sélectionner vos credentials TimescaleDB.
• Operation : menu déroulant requis, à configurer sur "Insert" pour cette action.
• Schema : champ texte requis spécifiant le schéma de base de données contenant votre table cible. Généralement "public" pour les configurations standard.
• Table : champ texte requis où vous indiquez le nom exact de la table dans laquelle insérer les données.
• Columns : champ texte requis acceptant une liste de noms de colonnes séparés par des virgules (exemple : "id,name,description,timestamp"). Ces colonnes seront peuplées avec les données entrantes.
• Return Fields : champ texte optionnel spécifiant les champs à retourner après l'insertion. Par défaut, "*" retourne toutes les colonnes de l'enregistrement inséré.
• Additional Fields : section optionnelle pour des configurations avancées comme la gestion des conflits.

Cas d'usage typiques :

• Insérer des données de capteurs IoT reçues via webhook dans une hypertable de métriques
• Enregistrer des événements utilisateur depuis votre application vers une table d'analytics
• Importer des données depuis un fichier CSV ou une API externe vers TimescaleDB

Utilisez cette action chaque fois que vous devez ajouter de nouvelles lignes à vos tables, notamment pour alimenter vos séries temporelles en continu.

L'action Update vous permet de modifier des enregistrements existants dans vos tables TimescaleDB. Elle est essentielle pour maintenir vos données à jour en fonction d'événements ou de corrections.

Paramètres de configuration :

• Credential to connect with : menu déroulant requis pour la sélection du credential TimescaleDB.
• Operation : menu déroulant requis, configuré sur "Update" pour cette action.
• Schema : champ texte requis indiquant le schéma de la base de données (généralement "public").
• Table : champ texte requis pour le nom de la table contenant les enregistrements à modifier.
• Update Key : champ texte requis spécifiant la colonne servant de clé primaire ou identifiant unique pour cibler les enregistrements à mettre à jour. Typiquement "id" ou une colonne unique.
• Columns : champ texte requis listant les colonnes à modifier, séparées par des virgules (exemple : "name,description,status").
• Return Fields : champ texte optionnel pour spécifier les champs retournés après la mise à jour. "*" retourne tous les champs par défaut.
• Additional Fields : section optionnelle pour ajouter des conditions ou propriétés supplémentaires.

Cas d'usage typiques :

• Mettre à jour le statut d'un enregistrement suite à un événement webhook
• Corriger des données erronées identifiées par un processus de validation
• Enrichir des enregistrements existants avec des informations provenant d'APIs tierces

Cette action est idéale lorsque vous devez modifier des données existantes plutôt qu'en créer de nouvelles, par exemple pour synchroniser des changements depuis un CRM ou un ERP.