Oracle SQL Query

Descripción

El modulo Oracle SQL Query permite ejecutar consultas SQL en bases de datos Oracle. Utiliza la libreria oracledb y soporta variables dinámicas en la consulta. Los resultados se devuelven en formato de objetos (OUT_FORMAT_OBJECT) para facilitar el procesamiento en nodos posteriores del workflow. Es ideal para integraciones con sistemas empresariales basados en Oracle Database.

Configuración

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

Credenciales

La credencial debe contener los campos:

• host: Dirección del servidor Oracle
• user: Usuario de la base de datos
• password: Contrasena del usuario
• database: Nombre del servicio/SID de Oracle
• port: Puerto de conexión (por defecto: 1521)

La cadena de conexión se construye como: host:port/database

Salida

{
  "nextModule": "siguiente_modulo",
  "data": [
    { "ID": 1, "NOMBRE": "Ejemplo", "ESTADO": "ACTIVO" }
  ]
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "cred_oracle_01",
  "query": "SELECT * FROM clientes WHERE ROWNUM <= 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: producto = "L'Oreal Shampoo"
INSERT INTO productos (nombre) VALUES ('{{producto}}')
-- SQL ejecutado: INSERT INTO productos (nombre) VALUES ('L''Oreal Shampoo')

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 (' → '')
• Los resultados se devuelven con formato de objetos (oracledb.OUT_FORMAT_OBJECT), es decir, cada fila es un objeto clave-valor
• Los nombres de columna en Oracle suelen estar en MAYUSCULAS
• La conexión se cierra automáticamente en el bloque finally
• En caso de error SQL, se incluye la consulta ejecutada en el mensaje de error

Nodos Relacionados

• sqlQuery (consultas en MySQL)
• sqlQueryMSSQL (consultas en SQL Server)
• sqlQueryPostgres (consultas en PostgreSQL)
• sqlQueryPostgresSSL (consultas en PostgreSQL con SSL)