Clase 04 · Módulo 07
Leer y escribir en Postgres desde n8n
Leer y escribir en Postgres desde n8n
Qué logras en esta clase
Conectas n8n a tu base en Supabase y haces las operaciones de todos los días: leer, insertar, actualizar y ejecutar SQL propio.
- Creas la credencial con el tipo de conexión correcto.
- Usas las operaciones del nodo Postgres.
- Escribes consultas con parámetros, sin riesgo.
- Revisas el SQL que te entrega Claude antes de ejecutarlo.
02
Dos nodos para la misma base
| Nodo Postgres | Nodo Supabase | |
|---|---|---|
| Se conecta a | La base, directo | La API de datos del proyecto |
| Credencial | Host, usuario y contraseña | Dirección del proyecto y clave secreta |
| Insertar o actualizar en un paso | Sí | No |
| SQL propio | Sí | No |
Esta clase usa el nodo Postgres. Sirve además para cualquier Postgres, esté o no en Supabase.
03
Sacar los datos de conexión
- Abre tu proyecto en el panel de Supabase.
- Haz clic en Connect, arriba.
- Elige el tipo de conexión (siguiente lámina).
- Copia host, puerto, usuario y nombre de la base desde la cadena que te muestra.
04
Tres tipos de conexión
| Tipo | Puerto | Red | Pensado para |
|---|---|---|---|
| Direct connection | 5432 | IPv6 | Servidores siempre encendidos |
| Session pooler | 5432 | IPv4 | Lo mismo, en redes solo IPv4 |
| Transaction pooler | 6543 | IPv4 | Funciones que abren conexiones muy cortas |
Un «pooler» es un intermediario que administra las conexiones a la base. IPv4 e IPv6 son las dos versiones de direcciones de internet; muchas redes solo tienen la primera.
05
Para n8n: Session pooler
n8n es un programa que queda encendido. Si no sabes si tu red tiene IPv6, usa Session pooler: funciona en todos los planes.
06
Crear la credencial en n8n
- En n8n, crea una credencial de tipo Postgres.
- Host: el que copiaste.
- Database: el nombre de base que aparece en la cadena.
- User: en el pooler tiene la forma
postgres.seguido de la referencia de tu proyecto. - Password: la contraseña de la base.
- Port: 5432 para Session pooler.
- SSL: elige Require para que la conexión viaje cifrada.
- Guarda y revisa que la prueba de conexión pase.
07
Si la conexión falla
| Síntoma | Causa probable |
|---|---|
| No encuentra el host o agota el tiempo | Usaste Direct connection en una red sin IPv6 |
| Falla la autenticación | Usuario sin la referencia del proyecto, o contraseña errada |
| Error de certificado | Revisa la opción SSL antes de tocar nada más |
08
Las seis operaciones
| Operación | Qué hace |
|---|---|
| Select | Lee filas con filtros y orden |
| Insert | Agrega filas |
| Update | Cambia filas existentes |
| Insert or Update | Actualiza si existe; si no, inserta |
| Delete | Borra filas, vacía o elimina la tabla |
| Execute Query | Ejecuta el SQL que escribas |
En todas, salvo Execute Query, eliges Schema (normalmente public) y Table desde una lista.
09
Select: leer sin escribir SQL
- Elige Select, el esquema y la tabla.
- En Select Rows agrega condiciones: columna, operador y valor.
- Con varias, define en Combine Conditions si se exigen todas (AND) o alguna (OR).
- En Sort ordena por una columna.
- Desactiva Return All y pon un Limit mientras pruebas.
Cada fila sale como un ítem, lista para los nodos que ya conoces.
10
Insert: de ítems a filas
Mapping Column Mode define cómo calzan los campos con las columnas:
| Modo | Cuándo |
|---|---|
| Map Each Column Manually | Eliges qué campo va a cada columna |
| Map Automatically | Los campos se llaman igual que las columnas |
11
Lo que la base te devuelve
Al insertar, la base asigna el id. La opción Output Columns permite pedir qué columnas devuelve el nodo.
Sirve para seguir el flujo con ese id: por ejemplo, insertar el pedido y luego insertar sus productos apuntando a él.
12
Insert or Update: el paso que evita duplicados
Indicas por cuál columna se reconoce la fila. Si ya hay una con ese valor, la actualiza; si no, la crea.
13
Insert or Update, con cuidado
- Reconoce la fila por un identificador estable, como
id_externo. Nunca por el nombre de la persona. - Mira en tu versión del nodo cómo se llama el campo donde eliges esa columna.
- La opción Skip on Conflict, en Insert, cubre el otro caso: si la fila ya existe, no hacer nada.
14
Execute Query: tu propio SQL
Cuando las operaciones visuales no alcanzan, escribes la consulta. Los valores variables van como $1, $2:
SELECT id, total, estado
FROM pedidos
WHERE correo = $1 AND created_at >= $2;En la opción Query Parameters entregas los valores, en el mismo orden:
{{ [ $json.correo, $json.desde ] }}15
Nunca pegues datos dentro del SQL
Con $1 y Query Parameters, n8n limpia los valores antes de enviarlos. Es la única forma aceptable cuando el dato viene de afuera.
16
Muchos ítems: Query Batching
| Valor | Qué hace |
|---|---|
| Single Query | Una sola consulta para todos los ítems |
| Independently | Una consulta por ítem |
| Transaction | Todas juntas: si una falla, se deshacen todas |
Transaction conviene cuando las filas solo tienen sentido completas, como un pedido y sus productos. Independently, cuando prefieres que las buenas entren aunque una falle.
17
Pedirle SQL a Claude
Entrégale el contexto:
- Cada tabla con sus columnas y tipos.
- Qué quieres obtener, en una frase.
- Dos o tres filas de ejemplo y el resultado esperado.
- Que es Postgres y que use parámetros
$1,$2.
18
Revisar el SQL antes de ejecutarlo
- Pídele a Claude que lo explique línea por línea.
- Busca la palabra inicial:
SELECTsolo lee;INSERT,UPDATEyDELETEmodifican. - Si es
UPDATEoDELETE, confirma que tieneWHERE. - Cambia primero la consulta a un
SELECTcon el mismoWHEREy cuenta las filas. - Recién entonces ejecuta la versión real.
19
Un UPDATE sin WHERE cambia toda la tabla
La base no pregunta «¿estás seguro?». Lo que escribes se ejecuta sobre todas las filas que calcen.
20
Delete trae tres comandos
En la operación Delete, el parámetro Command ofrece:
- Delete: borra las filas que cumplen las condiciones.
- Truncate: vacía la tabla completa.
- Drop: elimina la tabla.
21
Cuándo usar el nodo Supabase
Conviene para operaciones simples sobre una tabla: crear, leer, actualizar o borrar una fila.
- Credencial: Host con la dirección del proyecto y Secret Key.
- Exige que la API de datos del proyecto esté habilitada.
- Por defecto solo ve el esquema
public.
La clave secreta salta la seguridad de filas (clase anterior), igual que la conexión directa con el usuario postgres. Trata ambas como contraseñas maestras.
22
Errores comunes
| Error | Mejor |
|---|---|
| Leer toda la tabla para buscar una fila | Filtrar en el Select |
| Select para ver si existe y luego Insert | Insert or Update: otra ejecución puede colarse entre ambos pasos |
| Nodo Postgres dentro de un bucle de mil vueltas | Pasarle los mil ítems de una vez |
| Probar consultas nuevas en la tabla real | Tabla de pruebas con las mismas columnas |
23
Lo que te llevas
- Para n8n, Session pooler es la conexión que funciona en cualquier red.
- El host y el usuario se copian del panel, no se arman a mano.
- Insert or Update evita duplicados en un solo paso.
- Los valores externos entran con
$1y Query Parameters. - Todo
UPDATEoDELETEse prueba antes comoSELECT.
24
Hazlo ahora
En 15 minutos, con la tabla pedidos de la clase anterior:
- Crea la credencial Postgres con Session pooler.
- Con Select, trae las filas que agregaste a mano.
- Con Insert, agrega un pedido desde un Edit Fields (Set).
- Con Insert or Update por
id_externo, ejecuta dos veces el mismo pedido cambiando el total. - Revisa en Table Editor que haya una sola fila con el total nuevo.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026