Source SQL
A tarefa Source SQL permite executar consultas SQL diretamente em bancos de dados conectados ao Gaio DataOS. É ideal para extrair, transformar ou importar dados de fontes externas (como bancos de dados relacionais) para o seu projeto, para uso em fluxos de dados, análises e painéis.
Como usar
1. Abrir a Task
Navegue até: Tasks > ETL > Source SQL
2. Selecionar um banco de dados
No painel lateral esquerdo:
Selecione um banco de dados previamente registrado no ambiente e liberado para o seu User ID.
Após a seleção, todas as tabelas disponíveis dessa fonte serão exibidas.
3. Escrever o código SQL
Na aba Code:
Digite ou cole sua query SQL.
É possível utilizar sintaxe SQL avançada, incluindo JOIN, WHERE, GROUP BY, CTEs, entre outros.
Utilize Run query para testar o resultado antes de salvar a task.
4. Configurações (aba Settings)
Save on default repository: Salva o resultado da query como uma tabela no repositório local do projeto.
Incremental mode: Importa apenas novos registros, quando aplicável.
Field as string: Converte todos os campos para texto.
Create an empty table when no data: Cria a estrutura da tabela mesmo que a query não retorne dados.
Raw imports: Importa os dados sem formatação automática.
Auto columns (JDBC only): Detecta automaticamente a estrutura das colunas (apenas conexões JDBC).
JSForce Bulk Mode (Salesforce only): Otimiza a performance para importações em massa a partir do Salesforce.
Essas opções são especialmente úteis para controle de schema e performance em integrações com bases externas.
5. Aba Columns
Esta aba fica disponível apenas se a opção Save on default repository estiver habilitada.
Permite definir manualmente os nomes e tipos das colunas da tabela resultante, caso não queira que sejam detectados automaticamente.
6. Salvar e executar
Clique em Save para adicionar a task ao seu fluxo.
Em seguida, você pode encadear este passo com outras tasks, como transformação, visualização ou exportação.
Casos de uso
Consulta de dados em tempo real a partir de fontes externas (ex.: MySQL, PostgreSQL, Oracle, SQL Server)
Importação de dados de sistemas legados ou ERPs via SQL
Transformação de dados antes da ingestão diretamente por SQL
Automação de integrações com bancos de dados corporativos utilizando queries customizadas
Atualizado