# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/etl/source-sql.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.