Source SQL

La tarea Source SQL permite ejecutar consultas SQL directamente sobre bases de datos conectadas a Gaio DataOS.

Es ideal para extraer, transformar o importar datos desde fuentes externas (como bases de datos relacionales) hacia tu proyecto, para ser utilizados en flujos de datos, análisis y dashboards.


Cómo usar


1. Abrir la tarea

Navega a: Tasks > ETL > Source SQL


2. Seleccionar una base de datos

En el panel lateral izquierdo:

  • Selecciona una base de datos previamente registrada en el entorno y habilitada para tu usuario.

  • Una vez seleccionada, se mostrarán todas las tablas disponibles de esa fuente.


3. Escribir el código SQL

En la pestaña Code:

  • Escribe o pega tu consulta SQL.

  • Puedes utilizar sintaxis SQL avanzada, incluyendo JOIN, WHERE, GROUP BY, CTEs, entre otras.

circle-info

Usa Run query para probar los resultados antes de guardar la tarea.


4. Configuración (pestaña Settings)

  • Save on default repository: Guarda el resultado de la consulta como una tabla en el repositorio local del proyecto.

  • Incremental mode: Solo importa nuevos registros cuando sea aplicable.

  • Field as string: Convierte todos los campos a texto.

  • Create an empty table when no data: Crea la estructura de la tabla incluso si la consulta no devuelve datos.

  • Raw imports: Importa los datos sin formateo automático.

  • Auto columns (solo JDBC): Detecta automáticamente la estructura de columnas (solo para conexiones JDBC).

  • JSForce Bulk Mode (solo Salesforce): Optimiza el rendimiento para importaciones masivas desde Salesforce.

circle-exclamation

5. Pestaña Columns

  • Esta pestaña solo está disponible si Save on default repository está habilitado.

  • Permite definir manualmente los nombres y tipos de columnas para la tabla resultante, si no deseas que sean detectados automáticamente.


6. Guardar y ejecutar

  • Haz clic en Save para agregar la tarea a tu flujo.

  • Luego puedes vincular este paso con otras tareas (como transformación, visualización o exportación).


Casos de uso

  • Consultar datos en tiempo real desde una fuente externa (ej.: MySQL, PostgreSQL, Oracle, SQL Server).

  • Importar datos de sistemas legados o ERP mediante SQL.

  • Transformar datos antes de la ingesta directamente a través de SQL.

  • Automatizar integraciones con bases de datos empresariales mediante consultas personalizadas.

Última actualización