PostgreSQL Query

Descripción

El modulo PostgreSQL Query permite ejecutar consultas SQL en bases de datos PostgreSQL. Soporta variables dinámicas en la consulta, configuración flexible de SSL (incluyendo modos true, require, prefer y objetos SSL personalizados), y validación robusta de credenciales. Los resultados incluyen metadata con información de la conexión y la consulta ejecutada. Es ideal para leer y escribir datos en PostgreSQL dentro de flujos de trabajo automatizados.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales de conexión a PostgreSQL
query	code	Si	Consulta SQL a ejecutar (soporta variables {{variable}})

Credenciales

La credencial debe contener los campos:

• host: Dirección del servidor PostgreSQL (requerido)
• user: Usuario de la base de datos (requerido)
• password: Contrasena del usuario
• database: Nombre de la base de datos (requerido)
• port: Puerto de conexión (por defecto: 5432)
• ssl: Configuración SSL opcional (true, "require", "prefer", o un objeto SSL personalizado)

Salida

{
  "nextModule": "siguiente_modulo",
  "data": [
    { "id": 1, "nombre": "Ejemplo", "email": "test@test.com" }
  ],
  "_meta_": {
    "rowCount": 2,
    "queryExecuted": "SELECT * FROM usuarios",
    "connectionInfo": {
      "host": "localhost",
      "database": "midb",
      "ssl": false
    }
  }
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "cred_postgres_01",
  "query": "SELECT * FROM productos WHERE activo = true LIMIT 100"
}

Escape automático de comillas simples

Cuando una variable {{campo}} contiene un valor de texto con comillas simples, el motor las escapa automáticamente duplicandolas (' → '') antes de ejecutar la consulta. No es necesario ninguna función adicional.

-- Dato: empresa = "L'Oreal"
INSERT INTO clientes (empresa) VALUES ('{{empresa}}')
-- SQL ejecutado: INSERT INTO clientes (empresa) VALUES ('L''Oreal')

Los valores numericos no se escapan — usalos sin comillas en la plantilla: {{precio}}.

Notas

• Soporta variables dinámicas {{variable}} en la consulta SQL
• Los valores de texto con comillas simples se escapan automáticamente (' → '')
• La configuración SSL se detecta automáticamente desde las credenciales
• Si ssl es true o "true", se habilita SSL con rejectUnauthorized: false (comun para proveedores cloud)
• Si ssl es "require", se habilita SSL con validación de certificados
• La conexión se cierra siempre en el bloque finally
• Se validan los campos requeridos (host, user, database) antes de intentar la conexión
• En caso de error, se incluye el código de error PostgreSQL y la consulta ejecutada

Nodos Relacionados

• sqlQueryPostgresSSL (consultas en PostgreSQL con certificados SSL)
• sqlQuery (consultas en MySQL)
• sqlQueryMSSQL (consultas en SQL Server)
• sqlQueryOracle (consultas en Oracle)