Laboratorio 05: Consulta de Base de Datos con SQL Nativo

Validación de conexión y operaciones CRUD reales contra PostgreSQL desde n8n usando el nodo Execute Query.

Objetivo del Laboratorio

Configurar correctamente el nodo Execute Query de n8n con credenciales reales de PostgreSQL, escribir un INSERT que guarde datos de un webhook y un SELECT que devuelva la información para mostrarla en la salida del flujo con verificación de registro.

Configuración Técnica

Nodo Parámetros
Webhook Trigger POST, path /guardar-lead
Execute Query (INSERT) Operación: Insert. Schema y tabla: los que tengas creados. Modo: Map Automatically. Batching: Single Query
Execute Query (SELECT) Operación: Execute Query. SQL: SELECT * FROM leads WHERE email = $1. Parámetros: $json.body.email

Credenciales PostgreSQL esperadas:

Host: localhost
Port: 5432
Database: n8n_leads
User: n8n_user
Password: [tu contraseña en variable]
SSL: disable (local) / require (OCI)
Preparación previa

Antes de este lab debes tener la tabla PostgreSQL creada: CREATE TABLE leads (id SERIAL PRIMARY KEY, nombre TEXT, email TEXT UNIQUE, creado TIMESTAMP DEFAULT NOW());. Ejecútalo en tu cliente SQL (psql, DBeaver) una sola vez.

Ejecución del Flujo

  1. Copia la Test URL del nodo Webhook en n8n.
  2. En Postman, envía un POST con JSON: { "nombre": "Test Lead", "email": "test@lab5.com" }
  3. Verifica en el panel de ejecución que el nodo INSERT devuelve "success": true.
  4. Cambia a la segunda ejecución: SELECT debe devolver exactamente el registro que acabas de insertar.
  5. Verifica con SELECT * FROM leads; en tu terminal SQL que el registro persiste.
  6. Envía un duplicado (mismo email) y observa cómo n8n reporta el error de UNIQUE constraint — luego maneja el error con un nodo Error Trigger.
Hito Alcanzado

Eres capaz de usar n8n como ORM de facto para bases de datos, con INSERT parametrizado, verificación SELECT y manejo de colisiones de datos. Esta es la competencia que diferencia al automatizador amateur del profesional.

Verificación final del laboratorio 05

Cuando hayas ejecutado la práctica, marca cada punto para confirmar que completaste el trabajo. Solo tú decides si estás listo — sé honesto contigo.

💡 Este botón desbloquea la siguiente puerta del Máster.