> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/etl/source-sql.md).

# Source SQL

<figure><img src="/files/X4nK7zu3RQG7EyfCgFe0" alt=""><figcaption></figcaption></figure>

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.

{% hint style="info" %}
Utilize **Run query** para testar o resultado antes de salvar a task.
{% endhint %}

***

#### 4. Configurações (aba Settings)

<figure><img src="/files/UjinoAfoWA0cbmCWQSAO" alt=""><figcaption></figcaption></figure>

* **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.

{% hint style="warning" %}
Essas opções são especialmente úteis para controle de schema e performance em integrações com bases externas.
{% endhint %}

***

#### 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