> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciando Fontes de Dados

> Revise, teste e gerencie as conexões de banco de dados que fornecem dados para a geração de relatórios do Reporter.

Fontes de Dados são conexões que o Reporter usa para buscar os dados necessários para a geração de relatórios. Algumas Fontes de Dados já podem estar configuradas para produtos internos da Lerian, como o Midaz ou o CRM. Use esta página para revisar essas conexões, testá-las ou gerenciar conexões externas de banco de dados pelo [Lerian Console](https://docs.lerian.studio/pt/platform/console/about-lerian-console.md).

## O que é uma Fonte de Dados?

***

Uma Fonte de Dados é uma conexão entre o Reporter e um repositório de dados. Para gerar relatórios, o Reporter precisa de acesso aos dados de origem. Para dados de produtos internos, a conexão pode já existir. Para bancos de dados externos, os operadores podem adicionar e gerenciar a conexão nesta página.

Cada Fonte de Dados inclui:

* **Nome da conexão**: um identificador legível para humanos.
* **Tipo de banco de dados**: o mecanismo de banco de dados usado pela conexão: PostgreSQL ou MongoDB.
* **Configuração de acesso**: host, porta, nome do banco de dados, credenciais e modo SSL, quando a Fonte de Dados é uma conexão externa de banco de dados.
* **Schemas**: para conexões PostgreSQL, você pode especificar quais schemas acessar.
* **Metadados**: campos adicionais de chave-valor para organização.

Os operadores costumam usar esta página para responder a três perguntas:

* A conexão está disponível?
* Quais schemas, tabelas e campos o Reporter pode ler?
* Esta é a Fonte de Dados certa para o Template ou o Relatório que você está preparando?

## Bancos de dados aceitos

***

| Banco de dados | Porta padrão | Suporte a schemas |
| - | :-: | :-: |
| PostgreSQL | 5432 | ✅ |
| MongoDB | 27017 | ❌ |

## Acessando a página Fontes de Dados

***

Para abrir a página **Data Sources**, clique em **Configurações** no menu à esquerda da página do **Reporter** e depois em **Data Sources**.

Você não precisa começar por aqui em toda jornada do Reporter. Comece por aqui quando a Fonte de Dados necessária estiver ausente. Comece por aqui quando precisar adicionar um banco de dados externo, ou quando um relatório falhar porque os dados estão inacessíveis.

A página mostra todas as conexões configuradas, cada uma em um cartão com:

* Nome da conexão e tipo de banco de dados.
* Status da conexão (**Conectado**, **Desconectado**, **Conectando** ou **Não testado**) e o horário da última verificação.
* Schemas configurados (se houver).
* Latência da última verificação.
* Host, banco de dados, usuário e modo SSL.

Uma Fonte de Dados fornecida pelos seus produtos Lerian mostra **Fornecida pela plataforma**. Você não pode testar, editar nem excluir essa Fonte de Dados. Você pode testar uma Fonte de Dados marcada como **Gerenciado pelo ambiente**, mas não pode editá-la nem excluí-la.

Você pode expandir cada cartão para ver o schema do banco de dados, incluindo as tabelas e colunas disponíveis. Para uma Fonte de Dados MongoDB, a lista mostra **Coleções**. Um campo aninhado aparece recuado sob o campo pai, e um campo dentro de uma lista é marcado. Quando os documentos amostrados guardam mais de um tipo para um campo, o Console mostra um aviso.

### Ações disponíveis

Na página Fontes de Dados, você pode:

> [card] [Adicionar uma Fonte de Dados](https://docs.lerian.studio/pt/products/reporter/console/adding-a-data-source.md)
>
> Criar uma conexão externa reutilizável de banco de dados para o Reporter.

> [card] [Editar uma Fonte de Dados](https://docs.lerian.studio/pt/products/reporter/console/editing-a-data-source.md)
>
> Atualizar credenciais, host, schemas, SSL ou metadados.

> [card] [Testar a conexão](https://docs.lerian.studio/pt/products/reporter/console/testing-a-data-source.md)
>
> Confirmar que o Reporter consegue acessar o banco de dados e carregar as informações de schema.

> [card] [Excluir uma Fonte de Dados](https://docs.lerian.studio/pt/products/reporter/console/deleting-a-data-source.md)
>
> Remover conexões desativadas que você não usa mais.

> [!TIP]
>
> Se um Relatório falhar porque os dados estão ausentes ou inacessíveis, teste primeiro a Fonte de Dados. Depois verifique se o schema e a tabela esperados aparecem no cartão expandido.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.