Ressources · Intégration n8n

Intégration Azure Cosmos DB n8nAutomatiser Azure Cosmos DB avec n8n.

Tes documents Cosmos DB peuvent alimenter le reste de tes outils sans écrire une ligne de code. L'intégration Azure Cosmos DB n8n couvre 10 opérations réparties sur 2 ressources, les conteneurs et les items. Une requête SQL paramétrée en fait partie. De quoi monter des workflows au-dessus d'Azure.

Tester l'intégration Azure Cosmos DB sur n8nVoir les 10 opérations

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

Pourquoi automatiser

À quoi sert l'intégration Azure Cosmos DB n8n ?

L'intégration Azure Cosmos DB n8n, c'est un nœud livré avec n8n qui dialogue avec l'API Azure Cosmos DB depuis un workflow, c'est-à-dire une suite d'étapes automatisées. Il porte 2 ressources, Container et Item, et 10 opérations au total : créer ou supprimer un conteneur, en lire un ou lister les autres, puis créer, lire, mettre à jour, supprimer et interroger les documents qu'ils contiennent. Un seul credential enregistré sert à tout.

Premier usage, l'export du soir. Un Schedule Trigger se déclenche à heure fixe, item.getAll lit les documents d'un conteneur avec Return All activé, et le résultat atterrit dans Google Sheets pour les personnes qui n'ouvriront jamais le portail Azure. Avec Microsoft Excel 365 en sortie, le workflow ne bouge presque pas.

Deuxième usage, l'écriture. Un formulaire arrive, une ligne change dans Supabase, et item.create range le document correspondant dans Cosmos DB, avec la valeur de clé de partition déjà remplie depuis l'item entrant. Si le document existe déjà, c'est item.update qui remplace son contenu au lieu d'en créer un second.

Troisième usage, l'alerte filtrée. item.query lance une requête SQL sur un conteneur, les documents qui correspondent reviennent, et un message court part dans Slack seulement s'il y a matière. C'est là que le nœud prend tout son sens : le filtre tourne dans Cosmos DB, pas dans n8n, donc le workflow manipule quelques documents au lieu d'un conteneur entier.

Les 10 opérations listées plus bas, c'est ce que le nœud fait. Quand un workflow a besoin d'un appel qui n'en fait pas partie, le nœud HTTP Request atteint n'importe quel endpoint de l'API Azure Cosmos DB en réutilisant le même credential via l'authentification prédéfinie. Rien n'est à reconstruire.

Deux points méritent d'être connus avant le premier lancement. Cosmos DB compare les types de façon stricte : un filtre sur un nombre qui reçoit un paramètre texte ne renvoie rien, et c'est précisément le rôle de Query Parameters (JSON). Ensuite, le parseur JSON ne sait pas représenter avec une précision totale les entiers supérieurs à 9007199254740991, donc les très grandes valeurs numériques peuvent dériver en passant par ce champ. Si tu jauges encore la plateforme elle-même, l'Avis n8n traite le reste.

Connexion

Comment connecter Azure Cosmos DB à n8n ?

  1. 01

    Ouvrir le compte Azure d'abord

    Deux prérequis avant que n8n puisse parler à quoi que ce soit : un abonnement Azure, et un compte Azure Cosmos DB créé dessous. Le nœud s'authentifie avec un credential API Key, autrement dit un identifiant enregistré une fois dans n8n, et ce credential se construit à partir de valeurs qui n'existent qu'une fois le compte en place. Si l'abonnement appartient à quelqu'un d'autre dans la boîte, c'est l'étape à déléguer.

  2. 02

    Récupérer le compte, la clé et la base

    Le credential demande trois valeurs. Account, c'est le nom de ton compte Azure Cosmos DB. Key, c'est une clé de ce compte : dans le portail Azure, ouvre ton Cosmos DB, puis Overview et Keys. Les deux clés de compte fonctionnent aussi bien l'une que l'autre, donc pas de mauvais choix possible. Database, c'est le nom de la base à laquelle le workflow doit se connecter.

  3. 03

    Enregistrer le credential une seule fois

    Dans n8n, menu Credentials, crée un credential Azure Cosmos DB, colle les trois valeurs et enregistre. Un credential se crée une fois et se réutilise partout : chaque workflow suivant le choisit dans la liste déroulante du nœud, sans rien retaper. Pose ensuite le nœud Azure Cosmos DB dans un workflow, sélectionne le credential, et les champs Container commencent à proposer ce qui existe vraiment dans la base.

Actions

Que sait faire le nœud Azure Cosmos DB ?

Le nœud Azure Cosmos DB expose 10 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetGet ManyUpdateDeleteExecute Query
Container✓✓✓✓
Item✓✓✓✓✓✓

Container

4 opérations
01

Create container

container.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute un conteneur à la base nommée dans le credential, prêt à recevoir des documents.

Paramètres clés

  • ID : l'identifiant unique du nouveau conteneur, saisi directement ; le champ affiche Container1 en exemple.
  • Partition Key : une valeur JSON qui désigne la propriété servant à répartir les données entre les partitions, à choisir avec des valeurs très variées pour que le volume de requêtes se répartisse uniformément.
  • Indexing Policy, Max RU/s (for Autoscale) et Manual Throughput RU/s, dans Additional Fields : la politique d'indexation, le maximum en autoscale, et le débit manuel en unités de 100 unités de requête par seconde.
Cas d'usage
une inscription qui crée un conteneur par nouveau client et partitionne sur la propriété qui l'identifie.
02

Delete container

container.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un conteneur de la base visée par le credential. Un seul champ décide de tout ici, donc la réflexion porte sur ce qui le remplit.

Paramètres clés

  • Container : un resource locator vers le conteneur à supprimer, choisi dans la liste du nœud ou passé sous forme d'identifiant, par exemple {{ $json.containerId }} venu d'un nœud précédent.
Cas d'usage
un ménage de fin de chantier qui retire le conteneur temporaire monté pour une reprise de données, une fois les documents migrés contrôlés.
03

Get container

container.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un conteneur précis et renvoie sa définition, sans toucher aux documents qu'il contient.

Paramètres clés

  • Container : un resource locator vers le conteneur à récupérer, sélectionné dans la liste ou fourni par son identifiant.
  • Simplify : laissé actif, il renvoie une version simplifiée de la réponse ; désactivé, il rend les données brutes.
Cas d'usage
une première étape dans un workflow plus long, qui lit la définition du conteneur et oriente la suite selon ce qui revient, pour que l'écriture ne parte que sur le bon conteneur.
04

Get many containers

container.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie la liste des conteneurs de la base. Aucun champ obligatoire : l'opération tourne sur ce à quoi le credential est connecté.

Paramètres clés

  • Return All : coché, n8n enchaîne les pages de l'API et ramène tous les conteneurs ; décoché, il s'arrête à Limit.
  • Limit : le nombre maximal de conteneurs renvoyés quand Return All est désactivé.
  • Simplify : réponse simplifiée par défaut, données brutes si tu le désactives.
Cas d'usage
un inventaire hebdomadaire qui liste les conteneurs et écrit leurs noms dans un document partagé, pour garder la structure visible sans accès au portail.

Item

6 opérations
05

Create item

item.create

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un nouveau document dans un conteneur. Le document part d'un bloc, pas sous forme de colonnes mappées une par une.

Paramètres clés

  • Container : un resource locator vers le conteneur à utiliser.
  • Item Contents : le contenu de l'item sous forme d'objet JSON. L'indication du nœud vaut le détour : l'item exige un ID, et une valeur de clé de partition si une clé personnalisée est définie sur le conteneur.
Cas d'usage
un Webhook qui reçoit une commande, la remet en forme JSON et enregistre un document par commande.
06

Delete item

item.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un document existant, désigné à l'intérieur de son conteneur.

Paramètres clés

  • Container : un resource locator vers le conteneur à utiliser.
  • Item : un resource locator vers l'item à supprimer, choisi dans la liste ou passé par son identifiant.
  • Partition Key, dans Additional Fields : nécessaire uniquement si une clé de partition personnalisée est définie sur le conteneur.
Cas d'usage
une demande d'effacement où une étape de validation libère la suppression du document client, avec la trace de l'exécution conservée.
07

Get item

item.get

Ce que tu vois dans n8n

Notes & cas d'usage

Va chercher un document unique dans un conteneur et le passe au nœud suivant.

Paramètres clés

  • Container : un resource locator vers le conteneur à utiliser.
  • Item : un resource locator vers l'item à récupérer.
  • Simplify : actif pour une version simplifiée de la réponse, inactif pour les données brutes.
  • Partition Key, dans Additional Fields : nécessaire uniquement si une clé de partition personnalisée est définie sur le conteneur.
Cas d'usage
enrichir une notification avec le document client complet avant l'envoi, pour que le message porte de vraies valeurs et pas un identifiant.
08

Get many items

item.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Lit les documents d'un conteneur en bloc et les sort comme autant d'items dans le workflow.

Paramètres clés

  • Container : un resource locator vers le conteneur à utiliser.
  • Return All : coché, n8n parcourt les pages de l'API jusqu'au dernier document ; décoché, il s'arrête à Limit.
  • Limit : le nombre maximal de documents renvoyés.
  • Simplify : réponse simplifiée, ou données brutes une fois désactivé.
Cas d'usage
un récapitulatif récurrent qui lit un petit conteneur en entier et en tire un email de synthèse.
09

Query items

item.query

Ce que tu vois dans n8n

Notes & cas d'usage

Exécute une requête SQL NoSQL sur un conteneur et ne renvoie que les documents correspondants.

Paramètres clés

  • Query : la requête SQL à exécuter. Les repères $1, $2, $3 renvoient aux paramètres de requête, et n8n les convertit en @Param1, @Param2, @Param3 avant l'envoi, comme dans SELECT * FROM c WHERE c.status = $1 AND c.startDate = $2.
  • Options : Query Parameters, une liste de valeurs séparées par des virgules, toujours envoyées en texte, du type active,2024 ; Query Parameters (JSON), un tableau JSON qui conserve les types natifs, comme [1737062400000, "01234", true, null].
  • Simplify : actif par défaut, il retire les champs de métadonnées internes dont le nom commence par _.
Cas d'usage
sortir par statut les dossiers ouverts du jour et les router.
10

Update item

item.update

Ce que tu vois dans n8n

Notes & cas d'usage

Remplace le contenu d'un document qui existe déjà, sur place.

Paramètres clés

  • Container : un resource locator vers le conteneur à utiliser.
  • Item : un resource locator vers l'item à mettre à jour, choisi dans la liste ou passé par son identifiant.
  • Item Contents : le nouveau contenu de l'item, en objet JSON.
  • Partition Key, dans Additional Fields : nécessaire uniquement si une clé de partition personnalisée est définie sur le conteneur.
Cas d'usage
le transporteur signale un changement, le workflow retrouve le document de commande concerné et y inscrit le nouvel état de livraison.
Besoin d'aide

Besoin d'aide pour automatiser Azure Cosmos DB avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui viennent ensuite

01L'intégration Azure Cosmos DB n8n est-elle gratuite ?
Côté n8n, oui. Le nœud est livré avec n8n : rien à installer, aucun coût supplémentaire côté n8n, et le comportement est le même sur n8n Cloud, l'offre hébergée par n8n, que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans retouche. Ce que Microsoft facture pour l'abonnement Azure et le compte Cosmos DB est une autre question, et cette page ne la traite pas. Le nœud, lui, n'ajoute aucune licence par-dessus.
02Quels credentials faut-il pour le nœud Azure Cosmos DB ?
Un credential API Key, et c'est la seule méthode d'authentification prise en charge par ce nœud. Il contient trois valeurs. Account, le nom de ton compte Azure Cosmos DB. Key, une clé de ce compte, à récupérer dans le portail Azure via Overview puis Keys, sachant que les deux clés de compte conviennent. Database, le nom de la base à laquelle se connecter. Il faut au préalable un abonnement Azure et un compte Cosmos DB. Une fois enregistré dans le menu Credentials, ce credential se réutilise dans tous les workflows et se choisit dans la liste déroulante du nœud.
03Quelles limites faut-il avoir en tête avec le nœud Azure Cosmos DB ?
Trois points. La pagination d'abord : Return All décoché, le nœud s'arrête à Limit, donc un export incomplet vient presque toujours d'une case oubliée. Les types ensuite : Cosmos DB compare les types de façon stricte, et une requête qui filtre un nombre stocké avec un paramètre texte ne renvoie rien, d'où l'existence de Query Parameters (JSON) à côté de Query Parameters. La précision enfin : le parseur JSON ne représente pas fidèlement les entiers supérieurs à 9007199254740991, les très grandes valeurs peuvent donc perdre en exactitude. Et quand un appel de l'API n'a pas d'opération dédiée, le nœud HTTP Request y accède avec le même credential.
04Le nœud Azure Cosmos DB réagit-il en temps réel ?
Il n'existe pas de nœud trigger Azure Cosmos DB dans n8n, donc un workflow autour de cet outil démarre ailleurs. Trois portes d'entrée habituelles : un Schedule Trigger qui s'exécute à intervalle fixe et lit le conteneur, un Webhook, c'est-à-dire une URL n8n qu'un service tiers appelle quand quelque chose se passe chez lui, ou le trigger d'un autre outil déjà présent dans le workflow. En pratique, la première approche sert au reporting, la deuxième quand une application sait prévenir n8n d'elle-même. Le nœud fait ensuite la lecture ou l'écriture, une fois le workflow lancé.
05n8n ou Make pour Azure Cosmos DB ?
Ça dépend de quatre critères, et le prix n'est que l'un d'eux. L'hébergement : n8n s'auto-héberge avec Docker ou npm, ou s'utilise sur n8n Cloud, alors que Make est uniquement hébergé. La maîtrise des données : sur une instance auto-hébergée, les documents lus dans Cosmos DB restent sur une infrastructure qui t'appartient, ce qui compte quand la base contient des données clients. Le modèle de coût : Make facture à l'opération, donc un workflow qui lit un conteneur entier ne pèse pas pareil sur la facture. La logique visuelle : les deux se construisent à l'écran, et là c'est surtout une affaire d'habitude. Tranche sur les trois premiers.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations