> ## 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.
# Adicionar um Data Source
> Configure uma conexão externa de banco de dados quando o Reporter precisar de um Data Source que ainda não está disponível.
Use esta página para criar um Data Source quando o Reporter precisar ler de um banco externo ou de uma conexão que ainda não está configurada. Se o relatório usa dados internos de produtos Lerian, como Midaz ou CRM, o Data Source pode já existir.
## Objetivo
***
Configurar uma conexão externa que Templates e Relatórios possam usar.
Por exemplo, crie um Data Source chamado `production-postgres` que aponta para um banco externo de reporting, ou `compliance-readonly` para um usuário de banco somente leitura usado pelos operadores de reporting.
## Quando usar
***
Use esta tarefa quando:
* o Data Source necessário ainda não está disponível no Reporter;
* um novo banco precisa alimentar relatórios;
* um processo de relatório existente precisa de uma conexão somente leitura separada;
* os operadores precisam que schemas e campos estejam disponíveis no Template Builder ou em filtros de relatório.
Antes de adicionar um, verifique se o Data Source interno necessário já existe. Criar uma conexão externa duplicada é desnecessário quando o Reporter já tem a fonte configurada.
Não use esta tarefa para corrigir uma conexão existente. Use [Editar um Data Source](/pt/lerian-console/reporter-console/editing-a-data-source) e [Testar uma conexão de Data Source](/pt/lerian-console/reporter-console/testing-a-data-source).
## Antes de começar
***
Tenha estes dados em mãos:
* host, porta e nome do banco;
* usuário e senha;
* nomes dos schemas, quando o banco usa schemas;
* requisitos de SSL e certificado CA, quando exigidos pela infraestrutura;
* um nome de conexão claro, como `production-postgres` ou `compliance-readonly`.
Use credenciais destinadas ao acesso de reporting. Um Data Source dá ao Reporter acesso para ler dados usados em Templates e Relatórios.
## Passo a passo
***
Vá para **Data Sources** e clique em **Adicionar Data Source**.
Em **Adicionar Data Source**, informe **Nome da Conexão**, **Tipo de Banco de Dados**, **Host**, **Porta**, **Nome do Banco de Dados**, **Usuário** e **Senha**.
Para os tipos de banco em que o Console exibe **Schemas** (atualmente PostgreSQL no seletor), adicione os schemas que o Reporter deve inspecionar. Digite o nome do schema e clique em **Add**, ou pressione **Enter**.
Expanda **Configuração SSL**, ative **Habilitar SSL**, selecione **Modo SSL** e cole o **Certificado CA** se sua infraestrutura exigir.
Expanda **Metadata** para adicionar campos chave-valor que ajudem os operadores a classificar a conexão.
Clique em **Criar**.
O novo Data Source aparece com status **Desconectado**. Rode **Testar Conexão** antes de usá-lo em Templates ou Relatórios.
## Guia de campos
***
| Campo | O que informar | Exemplo |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| **Nome da Conexão** | Nome obrigatório visível ao operador. Campo técnico: `configName`. Validação no Console: 3 a 100 caracteres. | `production-postgres` |
| **Tipo de Banco de Dados** | Engine de banco obrigatório. O Console atualmente oferece `POSTGRESQL` e `MONGODB`. Campo técnico: `type`. | `POSTGRESQL` |
| **Host** | Endereço obrigatório do servidor de banco, não a URL de uma aplicação. Campo técnico: `host`. | `db.example.com` |
| **Porta** | Porta obrigatória do banco. Campo técnico: `port`; faixa válida 1 a 65535. | `5432` |
| **Nome do Banco de Dados** | Nome obrigatório do banco que o Reporter consultará. Campo técnico: `databaseName`. | `ledger` |
| **Usuário** | Usuário obrigatório do banco. Campo técnico: `username`. | `reporter_readonly` |
| **Senha** | Segredo obrigatório ao criar um Data Source. Campo técnico: `password`. | Armazenado pelo formulário |
| **Schemas** | Lista opcional de schemas para os tipos de banco suportados. Armazenado como `metadata.schemas`; as entradas são aparadas, convertidas para minúsculas e deduplicadas. | `public`, `pix`, `transactions` |
| **Habilitar SSL** | Toggle opcional de SSL. Quando ativado, o payload de conexão inclui `ssl`. | Ativado |
| **Modo SSL** | Obrigatório quando SSL está ativado. Use `disable`, `require`, `verify-ca` ou `verify-full`. Campo técnico: `ssl.mode`. | `verify-ca` |
| **Certificado CA** | Obrigatório para `verify-ca` e `verify-full`. Campo técnico: `ssl.ca`. | Certificado CA em PEM |
| Campos chave/valor de **Metadata** | Dados opcionais de classificação. Apenas linhas com chave não vazia são enviadas. Campo técnico: `metadata`. | `environment = production` |
## Resultado esperado
***
O novo Data Source externo aparece na página **Data Sources** com status **Desconectado** até ser testado. Após um teste bem-sucedido, os operadores podem usar os campos dele em Templates e Relatórios.
## Erros comuns e pontos de atenção
***
**Host** deve ser o endereço do servidor de banco, como `db.example.com`, não a URL de uma aplicação ou painel administrativo.
Se o banco usa schemas e o schema necessário não está listado, os operadores podem não ver as tabelas e campos esperados.
Se a infraestrutura exige SSL ou certificado CA, a conexão pode falhar até que **Configuração SSL** corresponda a esse requisito.
Nomes como `db1` são difíceis de usar com segurança. Prefira nomes que mostrem ambiente e propósito, como `production-compliance-readonly`.
## Próximos passos
***
* Use [Testar uma conexão de Data Source](/pt/lerian-console/reporter-console/testing-a-data-source) imediatamente após a criação.
* Use o [Template Builder](/pt/lerian-console/reporter-console/template-builder) para usar os campos do Data Source em um Template.
* Use [Gerar um Relatório](/pt/lerian-console/reporter-console/generating-a-report) quando o Template e o Data Source estiverem prontos.
[Endpoint Criar connection](/pt/reference/reporter/connections/create-connection)