Recursos · Integración n8n

Integración Azure Cosmos DB n8nAutomatiza Azure Cosmos DB con n8n.

Los documentos que guardas en Cosmos DB pueden llegar al resto de tus herramientas sin escribir código. La integración Azure Cosmos DB n8n reúne 10 operaciones repartidas en 2 recursos, contenedores e items, y una de ellas es una consulta SQL con parámetros tipados. Pensada para equipos que ya trabajan sobre Azure.

Probar la integración Azure Cosmos DB en n8nVer las 10 operaciones

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración Azure Cosmos DB n8n?

La integración Azure Cosmos DB n8n es un nodo que viene incluido en n8n y que habla con la API de Azure Cosmos DB desde dentro de un flujo de trabajo. Trae 2 recursos, Container e Item, y 10 operaciones entre ambos: crear o borrar un contenedor, leer uno o listarlos todos, y después crear, leer, actualizar, borrar y consultar los documentos guardados dentro. Todas las llamadas reutilizan una misma credencial guardada.

Caso número uno, el informe que nadie quiere montar a mano. Un Schedule Trigger salta a una hora fija, item.getAll lee los documentos de un contenedor con Return All activado y el resultado acaba en Google Sheets, donde lo consulta gente que nunca va a abrir el portal de Azure. Si el destino es Airtable, el flujo apenas cambia.

Caso número dos, la escritura de vuelta. Llega un formulario, se mueve una fila en Postgres, y item.create guarda el documento resultante en Cosmos DB con el valor de la clave de partición ya relleno desde el item de entrada. Cuando el documento ya existe, el que entra en juego es item.update, que sustituye su contenido en lugar de duplicarlo.

Caso número tres, el aviso con filtro. item.query lanza una consulta SQL contra un contenedor, vuelven solo los documentos que cuadran y sale un mensaje corto hacia Slack cuando hay algo que contar. Aquí es donde el nodo se gana el sitio: el filtro corre dentro de Cosmos DB y no en n8n, así que el flujo mueve unos pocos documentos en vez de un contenedor entero.

Las 10 operaciones que verás más abajo son lo que hace el nodo. Si un flujo necesita una llamada que no está entre ellas, el nodo HTTP Request alcanza cualquier endpoint de la API de Azure Cosmos DB reutilizando esa misma credencial mediante la autenticación predefinida, sin rehacer nada.

Hay dos detalles que conviene tener claros antes del primer lanzamiento. Cosmos DB compara tipos de forma estricta: un filtro sobre un número que recibe un parámetro de texto no devuelve nada, y para eso está Query Parameters (JSON). Y el parser de JSON no puede representar con precisión total los enteros por encima de 9007199254740991, de modo que los valores numéricos muy grandes pueden perder exactitud por esa vía. Si todavía estás aprendiendo la herramienta, el Curso n8n cubre el resto.

Conexión

¿Cómo se conecta Azure Cosmos DB con n8n?

  1. 01

    Abre primero la cuenta de Azure

    Hacen falta dos cosas antes de que n8n pueda hablar con nada: una suscripción de Azure y una cuenta de Azure Cosmos DB creada dentro. El nodo se autentica con una credencial API Key, es decir, un juego de datos de acceso que se guarda una sola vez en n8n, y esa credencial se arma con valores que solo existen cuando la cuenta ya está creada. Si la suscripción la lleva otra persona del equipo, este es el paso que toca delegar.

  2. 02

    Reúne la cuenta, la clave y la base de datos

    La credencial pide tres valores. Account es el nombre de tu cuenta de Azure Cosmos DB. Key es una clave de esa cuenta: en el portal de Azure, entra en tu Cosmos DB y selecciona Overview y luego Keys. Sirve cualquiera de las dos claves de cuenta, así que no hay forma de elegir mal. Database es el nombre de la base de datos a la que quieres que se conecte el flujo.

  3. 03

    Guarda la credencial una sola vez

    En n8n, entra en el menú Credentials, crea una credencial de Azure Cosmos DB, pega los tres valores y guarda. Una credencial se crea una vez y se reutiliza en todos los flujos: cada nodo la elige después en su lista desplegable y no hay que volver a teclear nada. Coloca luego el nodo Azure Cosmos DB en un flujo, selecciona la credencial y los campos Container empezarán a proponer lo que hay de verdad en la base.

Acciones

¿Qué sabe hacer el nodo de Azure Cosmos DB ?

El nodo Azure Cosmos DB expone 10 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDeleteExecute Query
Container✓✓✓✓
Item✓✓✓✓✓✓

Container

4 operaciones
01

Create container

container.create

Lo que ves en n8n

Notas y casos de uso

Añade un contenedor a la base de datos de la credencial, listo para recibir documentos.

Parámetros clave

  • ID: el identificador único del contenedor, escrito a mano; el campo muestra Container1 como ejemplo.
  • Partition Key: un valor JSON que señala la propiedad con la que Cosmos DB reparte los datos entre particiones. Elige una con valores muy variados para que el volumen de peticiones se reparta bien.
  • Indexing Policy, Max RU/s (for Autoscale) y Manual Throughput RU/s, en Additional Fields: la política de indexado, el máximo en autoescalado y el rendimiento manual en unidades de 100 unidades de petición por segundo.
Casos de uso
un alta que crea un contenedor por cuenta nueva y particiona por la propiedad del cliente.
02

Delete container

container.delete

Lo que ves en n8n

Notas y casos de uso

Quita un contenedor de la base de datos a la que apunta la credencial. Todo se decide en un solo campo, así que lo que importa es qué lo rellena.

Parámetros clave

  • Container: un resource locator hacia el contenedor que quieres borrar, elegido en la lista del nodo o pasado como identificador, por ejemplo {{ $json.containerId }} desde un nodo anterior.
Casos de uso
una limpieza final que retira el contenedor temporal montado para una carga puntual, cuando los documentos migrados ya están revisados.
03

Get container

container.get

Lo que ves en n8n

Notas y casos de uso

Recupera un contenedor concreto y devuelve su definición, sin tocar los documentos que hay dentro.

Parámetros clave

  • Container: un resource locator hacia el contenedor que quieres recuperar, seleccionado en la lista o indicado por su identificador.
  • Simplify: activo devuelve una versión simplificada de la respuesta; desactivado entrega los datos en bruto.
Casos de uso
un primer paso dentro de un flujo más largo, que lee la definición del contenedor y decide por dónde sigue según lo que vuelve, para que la escritura solo ataque al contenedor previsto.
04

Get many containers

container.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve la lista de contenedores de la base de datos. No pide ningún campo obligatorio: trabaja sobre aquello a lo que está conectada la credencial.

Parámetros clave

  • Return All: marcado, n8n recorre las páginas de la API y trae todos los contenedores; sin marcar, se detiene en Limit.
  • Limit: el número máximo de contenedores devueltos cuando Return All está apagado.
  • Simplify: respuesta simplificada por defecto, datos en bruto si lo desactivas.
Casos de uso
un inventario semanal que lista los contenedores y escribe sus nombres en un documento compartido, para que la estructura siga a la vista sin entrar al portal.

Item

6 operaciones
05

Create item

item.create

Lo que ves en n8n

Notas y casos de uso

Escribe un documento nuevo dentro de un contenedor. El documento viaja entero, no como columnas mapeadas una a una.

Parámetros clave

  • Container: un resource locator hacia el contenedor que quieres usar.
  • Item Contents: el contenido del item como objeto JSON. La indicación del nodo conviene leerla: el item exige un ID y un valor de clave de partición si el contenedor tiene una clave personalizada.
Casos de uso
un Webhook que recibe un pedido, lo pone en formato JSON y guarda un documento por pedido.
06

Delete item

item.delete

Lo que ves en n8n

Notas y casos de uso

Borra un documento existente, señalado dentro de su contenedor.

Parámetros clave

  • Container: un resource locator hacia el contenedor que quieres usar.
  • Item: un resource locator hacia el item que se va a borrar, elegido en la lista o pasado por su identificador.
  • Partition Key, en Additional Fields: solo hace falta si el contenedor tiene una clave de partición personalizada.
Casos de uso
una petición de supresión donde un paso de aprobación libera el borrado del documento del cliente y queda registrada la ejecución.
07

Get item

item.get

Lo que ves en n8n

Notas y casos de uso

Trae un único documento de un contenedor y se lo entrega al nodo siguiente.

Parámetros clave

  • Container: un resource locator hacia el contenedor que quieres usar.
  • Item: un resource locator hacia el item que quieres recuperar.
  • Simplify: activo para una versión simplificada de la respuesta, apagado para los datos en bruto.
  • Partition Key, en Additional Fields: solo hace falta si el contenedor tiene una clave de partición personalizada.
Casos de uso
completar un aviso con el documento entero del cliente antes de mandarlo, para que el mensaje lleve valores reales y no un identificador.
08

Get many items

item.getAll

Lo que ves en n8n

Notas y casos de uso

Lee de golpe los documentos de un contenedor y los saca como items del flujo.

Parámetros clave

  • Container: un resource locator hacia el contenedor que quieres usar.
  • Return All: marcado, n8n va pasando páginas de la API hasta el último documento; sin marcar, se detiene en Limit.
  • Limit: el número máximo de documentos devueltos.
  • Simplify: respuesta simplificada, o datos en bruto al desactivarlo.
Casos de uso
un resumen periódico que lee entero un contenedor pequeño y arma con él un correo de síntesis.
09

Query items

item.query

Lo que ves en n8n

Notas y casos de uso

Ejecuta una consulta SQL NoSQL contra un contenedor y devuelve solo los documentos que coinciden.

Parámetros clave

  • Query: la consulta SQL que se ejecuta. Las marcas $1, $2, $3 apuntan a los parámetros y n8n las convierte en @Param1, @Param2, @Param3 antes de enviar, como en SELECT * FROM c WHERE c.status = $1 AND c.startDate = $2.
  • Options: Query Parameters, una lista de valores separados por comas, siempre enviados como texto, del tipo active,2024; Query Parameters (JSON), un array JSON que conserva los tipos nativos, como [1737062400000, "01234", true, null].
  • Simplify: activo por defecto, retira los campos internos de metadatos cuyo nombre empieza por _.
Casos de uso
sacar por estado los expedientes abiertos del día y repartirlos.
10

Update item

item.update

Lo que ves en n8n

Notas y casos de uso

Sustituye, en el sitio, el contenido completo de un documento que ya existe en el contenedor.

Parámetros clave

  • Container: un resource locator hacia el contenedor que quieres usar.
  • Item: un resource locator hacia el item que se va a actualizar.
  • Item Contents: el contenido nuevo del item, como objeto JSON.
  • Partition Key, en Additional Fields: solo hace falta si el contenedor tiene una clave de partición personalizada.
Casos de uso
el transportista avisa de un cambio, el flujo localiza el documento del pedido y le escribe encima el nuevo estado de envío.
Necesitas ayuda

¿Necesitas ayuda para automatizar Azure Cosmos DB con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Lo que se pregunta justo después

01¿La integración Azure Cosmos DB n8n es gratuita?
Por el lado de n8n, sí. El nodo viene incluido con n8n, así que no hay nada que instalar ni coste añadido por su parte, y se comporta igual en n8n Cloud, la oferta alojada por n8n, que en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo montado en un sitio funciona en el otro sin retoques. Lo que cobra Microsoft por la suscripción de Azure y por la cuenta de Cosmos DB es otra cuestión y esta página no entra en ella. El nodo en sí no añade ninguna licencia encima.
02¿Qué credenciales pide el nodo de Azure Cosmos DB?
Una credencial API Key, que es el único método de autenticación admitido por este nodo. Guarda tres valores. Account, el nombre de tu cuenta de Azure Cosmos DB. Key, una clave de esa cuenta, que se saca del portal de Azure entrando en Overview y luego Keys, y sirve cualquiera de las dos claves de cuenta. Database, el nombre de la base de datos con la que conectar. Antes hacen falta una suscripción de Azure y una cuenta de Cosmos DB. Una vez guardada en el menú Credentials, la credencial se reutiliza en todos los flujos y se elige en la lista desplegable del nodo.
03¿Qué límites conviene tener en cuenta con el nodo de Azure Cosmos DB?
Tres. La paginación: con Return All apagado el nodo se detiene en Limit, así que un export a medias casi siempre es una casilla olvidada. Los tipos: Cosmos DB compara tipos de forma estricta y una consulta que filtra un número guardado con un parámetro de texto no devuelve nada, por eso existe Query Parameters (JSON) junto a Query Parameters. La precisión: el parser de JSON no representa con exactitud total los enteros mayores que 9007199254740991, y los números muy grandes pueden perder precisión por ahí. Y cuando un flujo necesita una llamada de la API sin operación propia, el nodo HTTP Request llega a ella con la misma credencial.
04¿El nodo de Azure Cosmos DB reacciona en tiempo real?
No existe un nodo trigger de Azure Cosmos DB en n8n, así que un flujo alrededor de esta herramienta arranca en otro sitio. Tres puertas de entrada habituales: un Schedule Trigger que se ejecuta cada cierto intervalo fijo y lee el contenedor, un Webhook, es decir una URL de n8n a la que llama un servicio externo cuando pasa algo de su lado, o el trigger de otra herramienta que ya esté en el flujo. En la práctica la primera se usa para informes y la segunda cuando una aplicación sabe avisar a n8n por su cuenta. El nodo se encarga después de leer o escribir, con el flujo ya en marcha.
05¿n8n o Make para Azure Cosmos DB?
Depende de cuatro criterios, y el precio es solo uno. El alojamiento: n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, mientras que Make funciona únicamente alojado. El control de los datos: en una instancia propia, los documentos que se leen de Cosmos DB se quedan en una infraestructura tuya, algo que pesa cuando la base guarda datos de clientes. El modelo de coste: Make factura por operación, así que un flujo que lee un contenedor entero no cuesta lo mismo. La lógica visual: los dos se montan en pantalla y ahí casi todo es costumbre. Decide por los tres primeros.
Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones