> 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/~/revisions/ZEf8tqpkUEBhycM8s1jE/tools/fonte.md).

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

####