Recursos · Integración n8n

Integración TimescaleDB n8nAutomatiza TimescaleDB con n8n.

¿Tus métricas se acumulan en TimescaleDB y nadie las toca hasta que alguien abre un cliente SQL? La integración TimescaleDB n8n abre una conexión directa contra la base y ofrece 3 operaciones sobre un único recurso: ejecutar SQL, insertar filas y actualizarlas. No trae trigger, así que otro nodo arranca la ejecución.

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

Por qué automatizar

¿Qué resuelve la integración TimescaleDB n8n?

El nodo TimescaleDB funciona como un cliente de base de datos dentro del flujo de trabajo, es decir, dentro de la secuencia de nodos que se ejecutan uno tras otro. Entra con un host, un nombre de base, un usuario y una contraseña, y a partir de ahí habla SQL con tu instancia. Tres operaciones y ninguna más: Execute Query para cualquier sentencia que escribas, Insert para añadir filas y Update para modificar las que ya existen.

El primer montaje que suele aparecer es el de guardado continuo. Un flujo consulta una fuente, ordena los datos y la operación Insert escribe una fila por cada item en la tabla que indiques. La plantilla pública con el número 917 enseña el esqueleto: un nodo HTTP Request recoge la posición de la Estación Espacial Internacional y el nodo TimescaleDB la almacena. Cambia la fuente y el patrón sirve igual para lecturas de sensores, contadores de una API o precios.

El segundo uso es corregir lo ya escrito. Un equipo cambia de nombre, un lote quedó con la etiqueta equivocada, un estado tiene que avanzar. Update recibe la tabla y una Update Key, la columna que señala qué filas entran en el cambio, y reescribe solo las columnas que enumeres. Las filas siguen ahí, no se borra nada.

El tercero mira hacia fuera: informes. Execute Query lanza la agregación, las filas vuelven como items y el nodo siguiente las reparte. Un aviso por Slack cuando un valor cruza el umbral, o una copia hacia Supabase para que la capa de aplicación la sirva. La consulta queda a la vista dentro del flujo, así que quien lo herede entiende de dónde sale cada número.

Hay un detalle que conviene entender antes de construir nada. La credencial de TimescaleDB abre una conexión contra una base de datos, con host, puerto y nombre de base. No es una API web. Por eso el recurso habitual de tirar del nodo HTTP Request cuando falta una operación aquí no aplica. El sustituto real es Execute Query: acepta cualquier sentencia SQL, así que todo lo que Insert y Update no cubren lo escribes tú en ese campo.

Dos límites más, para terminar. TimescaleDB no tiene nodo trigger en n8n, de modo que nada vigila la base: el arranque viene de un Schedule Trigger a intervalo fijo, de un Webhook de n8n que llama un servicio externo o del trigger de otra herramienta. Y un campo marcado como obligatorio bloquea la ejecución del nodo si se queda vacío. Si vienes de Postgres, el terreno te resultará conocido; la Reseña n8n entra en el alojamiento y la licencia, y el Curso n8n repasa las expresiones.

Conexión

¿Cómo conectar TimescaleDB con n8n?

  1. 01

    Reúne los datos de tu instancia

    Necesitas una instancia de TimescaleDB disponible y cinco valores suyos: el Host, que es el nombre completo del servidor o su dirección IP, la Database a la que conectarte, el User con el que iniciar sesión, el Password de ese usuario y el Port en el que escucha el servidor. Son los ajustes de conexión de tu instancia; n8n no los genera por ti.

  2. 02

    Guarda la credencial una sola vez

    Entra en el menú Credentials de n8n y crea una credencial de TimescaleDB. Una credencial es un juego de datos de acceso que se guarda una vez y luego aparece en el desplegable de cada nodo TimescaleDB que añadas. El nodo admite un único método de autenticación: la conexión a la base de datos. No hay pantalla de OAuth ni clave de API que rotar cada cierto tiempo.

  3. 03

    Ajusta el cifrado con SSL

    El selector SSL define el ssl-mode de la cadena de conexión. Require es el valor por defecto de las cadenas de conexión de TimescaleDB y solo intenta una conexión cifrada, comprobando que el certificado del servidor lo emitió una autoridad de confianza cuando existe un fichero de autoridad raíz. Allow prueba primero sin SSL y, si falla, con SSL. Disable solo prueba sin cifrar.

Acciones

Qué sabe hacer el nodo TimescaleDB

El nodo TimescaleDB expone 3 operaciones. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

01

Execute a SQL query

executeQuery

Lo que ves en n8n

Notas y casos de uso

Manda a la base la sentencia que escribas y devuelve su resultado. Un SELECT sale como items; una escritura solo se ejecuta.

Parámetros clave

  • Query: la consulta SQL que se ejecuta, obligatoria. Admite expresiones de n8n con la forma {{ $json.field }} o los marcadores $1 y $2 junto a los parámetros de consulta.
  • Query Parameters: dentro de Additional Fields, la lista separada por comas de las propiedades usadas como parámetros de consulta, como quantity,price.
  • Mode: también en Additional Fields, la manera de enviar las consultas. multiple, por defecto, manda varias a la vez, independently ejecuta cada una por separado y transaction las agrupa en una sola transacción.
Casos de uso
una agregación semanal cuyo resultado pasa al nodo que lo publica.
02

Insert rows in database

insert

Lo que ves en n8n

Notas y casos de uso

Cada item que entra se convierte en una fila nueva de la tabla indicada, sin redactar la sentencia INSERT.

Parámetros clave

  • Schema: obligatorio, el nombre del esquema al que pertenece la tabla.
  • Table: obligatorio, la tabla donde se insertan los datos.
  • Columns: lista separada por comas de las propiedades que se usan como columnas de las filas nuevas, por ejemplo id,name,description. Para fijar el tipo de dato de una columna, añade :type al nombre: id:int,name:text asigna int a id y text a name.
  • Return Fields: lista separada por comas de los campos que devuelve la operación.
Casos de uso
archivar cada lectura de un flujo periódico, como hace la plantilla 917 con la posición de la Estación Espacial Internacional.
03

Update rows in database

update

Lo que ves en n8n

Notas y casos de uso

Toca lo guardado en lugar de añadir filas: el nodo localiza filas por una columna y reescribe solo las columnas que enumeres.

Parámetros clave

  • Update Key: obligatorio, el nombre de la propiedad que decide qué filas de la base se actualizan. Lo normal es que sea id.
  • Schema y Table: obligatorios los dos: el esquema de la tabla y la tabla donde se actualizan los datos.
  • Columns: lista separada por comas de las propiedades que se usan como columnas de las filas a actualizar, del tipo name,description.
  • Return Fields: lista separada por comas de los campos que devuelve la operación.
Casos de uso
llevar el nuevo nombre de un equipo a sus filas históricas tras renombrarlo en el inventario.
Necesitas ayuda

¿Necesitas ayuda para automatizar TimescaleDB con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

TimescaleDB y n8n: preguntas frecuentes

01¿La integración TimescaleDB n8n es gratuita?
Por el lado de n8n, sí. El nodo TimescaleDB viene incluido con n8n, así que no hay nada que instalar ni ningún coste extra para desbloquearlo. Se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada que instales con Docker o npm, en Community Edition con licencia Sustainable Use. Un flujo creado en un sitio funciona en el otro sin retoques. Lo que cueste tu propia instancia de TimescaleDB es otro asunto, depende de cómo la explotes y esta página no lo trata.
02¿Qué credenciales pide el nodo TimescaleDB?
Un solo tipo, la conexión a la base de datos. Ni OAuth ni clave de API. Tienes que dar el Host, es decir el nombre completo del servidor o su dirección IP, la Database a la que conectarte, el User con el que iniciar sesión, el Password de ese usuario y el Port en el que escucha el servidor. El cifrado se ajusta con dos opciones más: el selector SSL, que fija el ssl-mode en allow, disable o require, e Ignore SSL Issues, que permite conectar aunque falle la validación del certificado. La credencial se crea una vez en el menú Credentials y después cada nodo la elige de su desplegable.
03¿Qué límites tiene el nodo TimescaleDB en n8n?
El nodo expone 3 operaciones sobre un único recurso: Execute Query, Insert y Update. Es una superficie estrecha a propósito, y la salida de emergencia no es la que suele esperarse. Como la credencial abre una conexión de base de datos y no una API web, aquí el nodo HTTP Request no sirve de recambio. Quien cumple ese papel es Execute Query, que acepta cualquier sentencia SQL: lo que las dos operaciones de escritura no cubran, lo redactas tú. Ten presente además que un campo marcado como obligatorio impide ejecutar el nodo si lo dejas vacío.
04¿El nodo TimescaleDB reacciona en tiempo real?
No reacciona solo. TimescaleDB no tiene nodo trigger en n8n, así que nada se queda vigilando la llegada de filas nuevas. Un flujo que toque TimescaleDB empieza en otro sitio: un Schedule Trigger que salta a intervalo fijo, un Webhook de n8n, o sea una dirección que le das a un servicio externo para que llame a tu flujo cuando pasa algo de su lado, o el trigger de otra herramienta que ya uses. En cuanto arranca ese primer nodo, la operación de TimescaleDB corre dentro de la misma ejecución.
05¿n8n o Make para TimescaleDB?
Depende de dónde quieras que vivan los datos y el gasto. Make es una plataforma de automatización alojada, sin opción de autoalojamiento, facturada por operación: un flujo que inserta miles de mediciones va consumiendo ese presupuesto mientras corre. n8n se autoaloja con Docker o npm, lo que mantiene el tráfico contra la base dentro de tu propia red, o se usa en n8n Cloud si prefieres no administrar servidores. Los dos ofrecen lógica visual sobre un lienzo. Decide por el alojamiento, el control de los datos, el modelo de coste y el lienzo que tu equipo lea más rápido.