# Fonte

<figure><img src="/files/14wRcomPcWfmcG0UinGX" alt=""><figcaption></figcaption></figure>

A aba **Sources** no ambiente do Gaio DataOS é onde o usuário desenvolvedor encontra e organiza todas as **fontes de dados disponíveis** para seu projeto. Ela permite acessar buckets de dados, conexões com bancos de dados e bases compartilhadas por outras aplicações, possibilitando a construção de fluxos analíticos completos.

***

### &#x20;1. Bucket Padrão do Projeto

Cada aplicação no Gaio possui **automaticamente seu próprio bucket**, visível no painel lateral de *Sources*. Esse bucket contém **todas as tabelas do projeto atual**, e é a principal área de armazenamento e consulta de dados para fluxos internos.

***

### &#x20;2. Compartilhamento de Buckets de Outras Aplicações

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

Além do bucket próprio, é possível **acessar buckets de outras aplicações**, caso estes tenham sido compartilhados com o projeto atual. Esse compartilhamento é feito por usuários administradores na área:

* **Settings > Project Share**\
  → Aqui, o admin pode escolher um projeto e selecionar quais buckets ou fontes serão visíveis para ele.

Após o compartilhamento, os buckets externos aparecerão na aba Sources do projeto selecionado, agrupados pelo nome da aplicação de origem.

***

### &#x20;3. Cadastro e Liberação de Fontes de Dados (Bancos)

<figure><img src="/files/7s6klYmYuHXYxX4nkJnL" alt=""><figcaption></figcaption></figure>

Administradores também podem configurar conexões com **bancos de dados externos**, como:

* PostgreSQL
* MySQL
* SQL Server
* Entre outros

Esse cadastro é feito em:

* **Settings > Sources (Admin only)**\
  → Cada fonte criada pode ser testada e editada, garantindo que a conexão esteja ativa e segura.

{% hint style="warning" %}
**Importante**: Após o cadastro da conexão, **o acesso à base deve ser liberado por usuário**. Isso é feito por meio da aba **Tags**, onde o administrador vincula usuários específicos àquela fonte de dados, garantindo controle e segurança.
{% endhint %}

***

### &#x20;4. Utilização no Flow

Após as permissões e compartilhamentos:

* Todas as fontes habilitadas aparecerão no painel *Sources* do Flow.
* O usuário pode **arrastar qualquer tabela** disponível para o fluxo de dados.
* As tabelas podem ser conectadas a Builders, enriquecidas, transformadas e armazenadas em novas tabelas no bucket do projeto.

***

#### &#x20;Exemplo de Uso Completo

1. O projeto "Ecommerce App" possui seu bucket com tabelas como `orders`, `products`, `customers`.
2. O admin compartilha o bucket da aplicação "CRM" com o "Ecommerce App" via **Project Share**.
3. O admin cadastra um banco MySQL externo na aba **Sources**, e libera esse banco para o usuário via **Tags**.
4. O desenvolvedor do projeto "Ecommerce App" agora vê:
   * Seu bucket com tabelas do projeto atual.
   * As tabelas do CRM compartilhadas.
   * O banco MySQL listado e acessível.
5. Ele arrasta as tabelas `crm_clients` e `orders`, usa um Builder e gera uma nova tabela `customer_orders`.


---

# 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/fonte.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.
