INTEGRACIÓN POSTGRES n8n: AUTOMATIZAR POSTGRES CON N8N

La acción Update modifica registros existentes en una tabla PostgreSQL según criterios que defines tú. Perfecta para sincronizar cambios desde aplicaciones externas, actualizar estados de pedidos o corregir datos masivamente sin SQL manual.

Parámetros clave:

• Credential to connect with: Credenciales PostgreSQL requeridas para conectar a tu base de datos (menú desplegable).
• Operation: Tipo de operación a ejecutar, aquí configurado como "Update" para modificar registros existentes.
• Schema: Especifica el schema donde se encuentra tu tabla. Requerido, generalmente configurado como "public" (seleccionable desde lista o expresión).
• Table: Tabla objetivo donde se ejecutará la actualización. Requerido, seleccionable desde un menú desplegable con las tablas disponibles en el schema elegido.

Casos de uso típicos:

• Actualizar el campo status de una tabla orders a "shipped" cuando un webhook de tu proveedor logístico confirma el envío.
• Sincronizar automáticamente precios desde una Google Sheet a tu tabla products cada noche.
• Modificar el campo last_login en users tras cada autenticación exitosa detectada por tu aplicación.

Cuándo usarlo: Ideal cuando necesitas reflejar cambios de estado o información procedente de otros sistemas en tiempo real. Combínalo con filtros condicionales en n8n para actualizar únicamente registros que cumplan criterios específicos.

La acción Select recupera datos de tu base de datos PostgreSQL según los criterios que definas. Esencial para construir dashboards dinámicos, validar información antes de procesarla o alimentar otros nodos de tu workflow con datos actualizados.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación para tu cuenta Postgres (menú desplegable requerido).
• Operation: Define la operación como "Select" para recuperar datos de la base de datos.
• Schema: Schema donde reside tu tabla objetivo. Requerido, configurable desde lista o expresión dinámica (por defecto "public").
• Table: Tabla específica desde la cual extraer datos. Requerido, seleccionable desde menú desplegable con las tablas del schema.

Casos de uso típicos:

• Recuperar lista de clientes activos cada mañana y enviarla automáticamente por email al equipo comercial.
• Extraer pedidos pendientes de tu tabla orders para alimentar un webhook hacia tu sistema de facturación.
• Consultar registros de logs de errores para activar alertas Slack cuando se detectan patrones anómalos.

Cuándo usarlo: Usa Select cada vez que necesites leer información de Postgres para tomar decisiones en tu workflow. Combínalo con filtros avanzados y cláusulas WHERE personalizadas para recuperar exactamente los datos que necesitas.

La acción Insert or Update (también conocida como UPSERT) inserta nuevos registros en tu tabla o actualiza los existentes si ya se encuentran, basándose en una clave única que defines. Extremadamente útil para sincronizaciones bidireccionales sin duplicados.

Parámetros clave:

• Credential to connect with: Credenciales PostgreSQL requeridas (menú desplegable).
• Operation: Configurado como "Insert or Update", permite añadir o modificar registros según si existen previamente.
• Schema: Schema de tu base de datos donde reside la tabla objetivo. Configurable desde lista, habitualmente "public" (requerido).
• Table: Tabla donde ejecutar el upsert. Requerido, seleccionable desde menú desplegable con tablas disponibles.

Casos de uso:

• Sincronizar contactos desde HubSpot: si el contacto existe (basado en email), actualiza sus datos; si no, créalo.
• Mantener actualizada una tabla de inventario sin generar duplicados cuando recibes actualizaciones de stock desde múltiples fuentes.
• Importar transacciones desde Stripe: inserta nuevas transacciones y actualiza las existentes si cambian de estado.

Cuándo usarlo: Ideal para pipelines de sincronización donde no quieres gestionar lógica compleja de "verificar si existe antes de insertar". Postgres maneja esto eficientemente con constraints de clave única.

La acción Insert añade nuevos registros a una tabla PostgreSQL específica. Simple pero fundamental para alimentar bases de datos desde formularios web, APIs externas o cualquier fuente de datos conectada a n8n.

Parámetros clave:

• Credential to connect with: Selección de credenciales Postgres configuradas en n8n (menú desplegable requerido).
• Operation: Define la acción como "Insert" para añadir nuevos registros a la tabla.
• Schema: Especifica el schema objetivo donde insertar datos. Requerido, típicamente "public" (seleccionable o expresión).
• Table: Tabla destino para la inserción. Requerido, seleccionable desde lista de tablas disponibles en el schema.

Casos de uso:

• Registrar cada nuevo lead capturado desde un formulario Typeform directamente en tu tabla leads.
• Almacenar logs de eventos críticos de tu aplicación en una tabla app_events cada vez que detectas una anomalía.
• Crear registros de auditoría insertando metadata de cada acción sensible ejecutada en tus workflows.

Cuándo usarlo: Usa Insert cuando estás seguro de que añades registros nuevos sin riesgo de duplicados. Si necesitas evitar duplicados basándote en claves únicas, prefiere Insert or Update.

La acción Execute Query ejecuta consultas SQL personalizadas directamente contra tu base de datos PostgreSQL. Máxima flexibilidad para operaciones complejas: JOINs, subconsultas, procedimientos almacenados, transacciones... todo lo que Postgres soporta.

Parámetros clave:

• Credential to connect with: Credenciales de conexión Postgres requeridas (menú desplegable).
• Operation: Configurado como "Execute Query", permite ejecutar cualquier sentencia SQL válida.
• Query: Campo de texto multilínea donde introduces tu consulta SQL personalizada. Requerido. Soporta parámetros dinámicos para prevenir inyecciones SQL (ver nota de seguridad en interfaz).

Options (opcional):

• Query Parameters: Define parámetros seguros ($1, $2...) para inyectar valores dinámicos en tu query sin exponer tu base de datos a SQL injection. Altamente recomendado para queries con inputs externos.

Casos de uso:

• Ejecutar un JOIN complejo entre orders y customers para generar reportes analíticos personalizados.
• Llamar procedimientos almacenados que ejecutan lógica de negocio compleja ya definida en tu base de datos.
• Actualizar múltiples tablas relacionadas en una sola transacción para garantizar consistencia de datos.

Cuándo usarlo: Cuando las acciones estándar (Select, Insert, Update) no cubren tu caso de uso. Requiere conocimientos SQL pero ofrece control total sobre tu base de datos. Combínalo siempre con parámetros de query para evitar vulnerabilidades.

💡 CONSEJO: Usa siempre parámetros de query ($1, $2...) en lugar de concatenar valores directamente en tu SQL. Ejemplo: SELECT * FROM users WHERE email = $1 con parámetro $1 = {{$json.email}}. Esto previene inyecciones SQL y protege tu base de datos.

La acción Delete elimina registros de una tabla PostgreSQL según criterios que especifiques. Crítica para mantener tu base de datos limpia, cumplir políticas GDPR o automatizar purgas de datos obsoletos.

Parámetros clave:

• Credential to connect with: Credenciales Postgres requeridas para conectar (menú desplegable).
• Operation: Configurado como "Delete" para eliminar registros de la tabla objetivo.
• Schema: Schema donde reside tu tabla. Requerido, seleccionable desde lista o expresión dinámica (típicamente "public").
• Table: Tabla desde la cual eliminar registros. Requerido, seleccionable desde menú desplegable con tablas del schema.

Casos de uso:

• Eliminar automáticamente registros de temp_sessions más antiguos de 24h cada noche.
• Purgar datos de usuarios que solicitaron eliminación según GDPR, activado por webhook de tu aplicación.
• Borrar pedidos en estado "cart_abandoned" después de 30 días para mantener tu base de datos optimizada.

Cuándo usarlo: Usa Delete con precaución, siempre combinado con filtros WHERE precisos en tus criterios. Considera hacer backups antes de operaciones de eliminación masivas. Ideal para workflows programados que mantienen higiene de datos. Para backups automatizados, consulta nuestra guía de backup automático con n8n.