INTÉGRATION AZURE COSMOS DB n8n : AUTOMATISER AZURE COSMOS DB AVEC N8N

L'action "Query items" vous permet d'exécuter des requêtes SQL personnalisées contre vos items Cosmos DB directement depuis n8n. C'est l'action la plus puissante pour extraire des données spécifiques selon vos critères métier, sans être limité aux opérations CRUD basiques.

Paramètres clés :

• Credential to connect with : Sélectionnez vos identifiants Azure Cosmos DB (requis)
• Resource : Type de ressource à interroger, ici "Item" (requis)
• Operation : Fixé sur "Execute Query" pour cette action
• Container : Spécifiez le conteneur cible par ID ou via une expression (requis)
• Query : Votre requête SQL à exécuter, par exemple SELECT * FROM c WHERE c.status = 'active' (requis)
• Simplify : Activez cette option pour obtenir une sortie simplifiée (optionnel)
• Options : Section pour ajouter des paramètres et prévenir les injections SQL (optionnel mais recommandé)

Cas d'usage typiques : Extraire tous les clients ayant passé commande ce mois-ci pour un rapport automatisé, filtrer les produits en rupture de stock pour déclencher des alertes, rechercher des documents selon des critères complexes combinant plusieurs champs.

L'action "Update item" permet de modifier un item existant dans votre conteneur Cosmos DB. Idéale pour maintenir vos données à jour automatiquement suite à des événements dans d'autres applications connectées à n8n.

Paramètres clés :

• Credential to connect with : Vos identifiants Azure Cosmos DB (requis)
• Container : Le conteneur contenant l'item à modifier, sélectionnable par ID (requis)
• Item : L'identifiant de l'item à mettre à jour (requis)
• Item Contents : Le nouveau contenu de l'item au format JSON (requis)
• Additional Fields : Permet d'ajouter une Partition Key si nécessaire (optionnel)

Cas d'usage typiques : Mettre à jour le statut d'une commande quand un paiement Stripe est confirmé, synchroniser les informations de contact depuis HubSpot vers Cosmos DB, actualiser des compteurs ou métriques suite à des événements applicatifs.

L'action "Delete item" supprime un item spécifique d'un conteneur Cosmos DB. Utile pour automatiser le nettoyage de données ou gérer les demandes de suppression RGPD.

Paramètres clés :

• Credential to connect with : Vos identifiants de connexion (requis)
• Container : Le conteneur où se trouve l'item, identifiable par ID (requis)
• Item : L'identifiant unique de l'item à supprimer (requis)
• Additional Fields : Ajoutez une Partition Key si votre schéma l'exige (optionnel)

Cas d'usage typiques : Supprimer automatiquement les sessions expirées après un délai défini, traiter les demandes de suppression de compte utilisateur, nettoyer les données temporaires ou de test.

L'action "Get container" récupère les informations d'un conteneur spécifique dans votre compte Cosmos DB. Pratique pour vérifier l'existence ou les propriétés d'un conteneur avant d'effectuer des opérations.

Paramètres clés :

• Credential to connect with : Identifiants Azure Cosmos DB (requis)
• Resource : Fixé sur "Container" pour cette action (requis)
• Operation : Fixé sur "Get" (requis)
• Container : Identifiant du conteneur à récupérer, par ID ou expression (requis)
• Simplify : Simplifie la réponse pour un traitement plus facile (optionnel)

Cas d'usage typiques : Vérifier qu'un conteneur existe avant d'y insérer des données, récupérer les métadonnées d'un conteneur pour du monitoring, valider la configuration d'un conteneur dans un workflow de déploiement.

L'action "Create item" insère un nouvel item dans un conteneur Cosmos DB. C'est l'action fondamentale pour alimenter votre base de données depuis n'importe quelle source connectée à n8n.

Paramètres clés :

• Credential to connect with : Vos identifiants Azure (requis)
• Container : Le conteneur de destination, sélectionnable par ID (requis)
• Item Contents : Le contenu JSON de l'item à créer, doit inclure au minimum un champ "id" (requis)

Cas d'usage typiques : Enregistrer automatiquement les soumissions de formulaires web, archiver des événements ou logs depuis des webhooks, créer des enregistrements client suite à une inscription.

L'action "Create container" permet de créer un nouveau conteneur dans votre compte Cosmos DB. Indispensable pour les workflows de provisioning automatisé ou la gestion multi-tenant.

Paramètres clés :

• Credential to connect with : Identifiants de connexion (requis)
• ID : Identifiant unique du nouveau conteneur, par exemple "Container1" (requis)
• Partition Key : Configuration JSON de la stratégie de partitionnement incluant les paths (ex: "/id"), le kind ("Hash") et la version (requis)
• Additional Fields : Options supplémentaires selon vos besoins (optionnel)

Cas d'usage typiques : Créer automatiquement un conteneur dédié pour chaque nouveau client, provisionner des environnements de test à la demande, automatiser le déploiement d'une architecture multi-conteneurs.

L'action "Get item" récupère un item spécifique depuis un conteneur Cosmos DB. Parfaite pour obtenir des données précises à utiliser dans les étapes suivantes de votre workflow.

Paramètres clés :

• Credential to connect with : Vos identifiants Azure Cosmos DB (requis)
• Container : Le conteneur source, identifiable par ID (requis)
• Item : L'identifiant de l'item à récupérer (requis)
• Simplify : Simplifie la structure de la réponse (optionnel)
• Additional Fields : Permet d'ajouter une Partition Key (optionnel)

Cas d'usage typiques : Récupérer les détails d'un client pour personnaliser un email, obtenir la configuration d'un produit avant traitement, charger des données de référence pour enrichir un flux.

L'action "Delete container" supprime un conteneur entier de votre compte Cosmos DB. À utiliser avec précaution, mais essentielle pour les workflows de nettoyage ou de décommissionnement.

Paramètres clés :

• Credential to connect with : Identifiants de connexion Azure (requis)
• Resource : Fixé sur "Container" (requis)
• Operation : Fixé sur "Delete" (requis)
• Container : L'identifiant du conteneur à supprimer, par ID ou expression (requis)

Cas d'usage typiques : Supprimer des conteneurs de test après une période définie, automatiser le décommissionnement de clients inactifs, nettoyer des environnements temporaires.

L'action "Get many items" récupère plusieurs items d'un conteneur en une seule opération. Idéale pour les traitements en masse ou la synchronisation de données.

Paramètres clés :

• Credential to connect with : Vos identifiants Azure Cosmos DB (requis)
• Container : Le conteneur source (optionnel mais recommandé)
• Return All : Active la récupération de tous les items sans limite (optionnel)
• Limit : Nombre maximum d'items à récupérer, par défaut 50 (optionnel)
• Simplify : Simplifie le format de sortie (optionnel)

Cas d'usage typiques : Exporter périodiquement des données vers un autre système, générer des rapports agrégés sur l'ensemble des données, synchroniser un catalogue produits avec une plateforme e-commerce.

L'action "Get many containers" liste les conteneurs disponibles dans votre compte Cosmos DB. Utile pour l'administration, l'audit ou la création de workflows dynamiques.

Paramètres clés :

• Credential to connect with : Identifiants de connexion (requis)
• Return All : Récupère tous les conteneurs sans limite (optionnel)
• Limit : Nombre maximum de conteneurs à retourner, défaut 50 (optionnel)
• Simplify : Simplifie la structure des données retournées (optionnel)

Cas d'usage typiques : Auditer les conteneurs existants pour un rapport de conformité, lister dynamiquement les conteneurs pour une interface d'administration, monitorer le nombre de conteneurs dans un compte.