DB Connector

• Task Type: db

El tarea DB Connector permite ejecutar instrucciones SQL en una base de datos soportada, tanto para la extracción de datos —con posibilidad de mapear los resultados en alias específicos— como para la ejecución de código procedural. La configuración requiere la definición de la conexión a la base de datos y de la consulta SQL que se va a ejecutar, finalizada para el recuperación de información o la ejecución de operaciones.

Conexión a la Base de Datos

Parámetro	Descripción
Tipología Base de Datos	El tipo de base de datos (DBMS) a la que conectarse
Conexión SSL	Activada/Desactivada
Host	host o #>parametro_string<#
Puerto	port o #>parametro_num<#
Nombre DB	nome_database o #>parametro_string<#
User	nome_utente o #>parametro_string<#
Password	Contraseña de acceso

Configuración del Statement

Tipología Statement

• Select: ejecuta consultas SQL para la extracción de datos del base de datos.
• Otro (Other): permite la ejecución de instrucciones DML (INSERT, UPDATE, DELETE), llamadas a procedimientos/stored procedure o bloques anónimos SQL.

Ejemplo de Preview de la Consulta SQL (Statement Preview)

La preview guarda la configuración actual antes de ejecutar la consulta y limita el número de filas mostradas. Está disponible también con SAP HANA. En caso de error se muestra un código diagnóstico útil para solicitar asistencia.

SELECT
config->>'kid' AS kid,
config->>'iss' AS iss,
config->>'scope' AS scope,
config->>'grant_type' AS grant_type,
config->>'project_id' AS project_id,
replace(config->>'key', chr(10), '\n') AS key,
config->>'aud' AS aud
FROM connections
WHERE id=1;

Ejemplo de Mapeo de los Campos Extraídos

Tipo	Precisión	Alias	Expresión
EXPRESION	1000	kid	config->>'kid'
EXPRESION	1000	iss	config->>'iss'
EXPRESION	1000	scope	config->>'scope'
EXPRESION	1000	grant_type	config->>'grant_type'
EXPRESION	1000	project_id	config->>'project_id'
EXPRESION	2000	key	replace(config->>'key', chr(10), '\n')
EXPRESION	1000	aud	config->>'aud'

Ejemplo de Clausula From

FROM connections
WHERE id=1;

Uso parámetro dinámico con "dbobj:"

FROM `#>dbobj:nome_tabella<#` 

Gestión Table Structure - Campos select list

En la parte inferior derecha de la tabla de mapeo en la “Tipología Statement Select - Campos select list” se encuentran tres botones:

Botón	Acción
Guardar	Guarda la estructura definida
Importar	Importa una estructura existente
Exportar	Exporta la estructura definida

Esta funcionalidad permite guardar, exportar o reutilizar las mapeaturas, evitando la compilación manual de los campos y reduciendo el riesgo de errores.

Nota Técnica

• Visibilidad: Las estructuras guardadas en el sistema son visibles exclusivamente al usuario que las ha creado.
• Profundización: Para una descripción detallada de todas las opciones y la lógica de funcionamiento, hacer referencia a la página Estructura de la tabla.

Parámetros de Salida

Al término de la ejecución de una consulta, la tarea "DB Connector" expone un conjunto de parámetros de salida. Estos parámetros proporcionan no solo un resumen de la operación, sino también los datos recuperados en múltiples formatos, listos para ser utilizados por las tareas siguientes.

Parámetros Relativos al Espool de la Consulta

• queryspool.file: Devuelve la ruta completa del archivo de espool generado (un archivo CSV).
• queryspool.filename: Devuelve solo el nombre del archivo de espool.
• queryspool.content: Contiene todo el contenido textual del archivo de espool.

Parámetros de Resumen de Ejecución

• count: Indica el número total de filas (registros) devueltas por la consulta.
• result: Proporciona el estado general de la ejecución de la tarea (por ejemplo, "Statement Ejecutado con éxito" o un mensaje de error de la base de datos).
• resultJson: representa el resultado de la ejecución de la tarea en formato JSON, incluyendo información general, configuraciones y detalles sobre la ejecución.

Parámetros de Exportación de Datos

Estos parámetros contienen el conjunto completo de datos recuperado, ya formateado en varios estándares.

• DataExportCsv: Devuelve el conjunto de datos completo, formateado como texto en formato CSV, incluida la fila de encabezado con los nombres de las columnas.
• DataExportNoHeaderCsv: Devuelve el conjunto de datos en formato CSV, pero excluyendo la fila de encabezado. Es útil cuando se necesita solo los datos brutos.
• DataExportJson: Devuelve el conjunto de datos completo, formateado como una cadena JSON (un array de objetos, donde cada objeto representa una fila).

Parámetros Objeto para Elaboración Avanzada

Estos parámetros representan los datos como objetos estructurados, ideales para la interacción con otras tareas.

• Dataset: Este parámetro representa el nombre de la columna de la tabla (Por ejemplo: name). Es el parámetro más importante para conectar esta tarea a un Iterador. Para acceder a los valores de una columna específica durante una iteración, se utiliza la sintaxis Dataset.NombreColumna.
• DataColumn: Este parámetro permite acceder al contenido completo de una columna como una única entidad).
• DataColumn.NombreColumna: Devuelve todos los valores de la columna “NombreColumna”. Por ejemplo: “Luca, Maria, Giovanni, Elena”

Notas importantes

• Para usar los parámetros dinámicos en la sección de la Cláusula FROM y Statement, se debe utilizar la siguiente sintaxis: "#>dbobj:parametro_dinamico<#" (excluyendo el Tipo de Base de Datos SAP HANA, en cuyo caso se debe utilizar la sintaxis habitual "#>nome_tabella<#").

Ejemplo del parámetro resultJson

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}