> ## 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 uma Fonte de Dados > Configure uma conexão de banco de dados externa quando o Reporter precisar de uma fonte de dados que ainda não está disponível no Console da Lerian para a geração de relatórios. Use esta página para criar uma Fonte de Dados quando o Reporter precisar ler de um banco de dados externo ou de uma conexão que ainda não está configurada. Se o relatório usa dados internos de produtos Lerian, como o Midaz ou o CRM, a Fonte de Dados pode já existir. ## Objetivo *** Configure uma conexão externa que Templates e Relatórios podem usar. Por exemplo, crie uma Fonte de Dados chamada `production-postgres` que aponta para um banco de dados de relatórios externo, ou `compliance-readonly` para um usuário de banco de dados somente leitura usado pelos operadores de relatórios. ## Quando usar *** Use esta tarefa quando: * a Fonte de Dados necessária ainda não está disponível no Reporter * um novo banco de dados deve alimentar relatórios * um processo de relatório existente precisa de uma conexão somente leitura separada * os operadores precisam de esquemas e campos disponíveis no Template Builder ou em filtros de relatório Antes de adicionar uma, verifique se a Fonte de Dados interna necessária 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 uma Fonte de Dados](/pt/products/reporter/console/editing-a-data-source) e [Testar a conexão de uma Fonte de Dados](/pt/products/reporter/console/testing-a-data-source). ## Antes de começar *** Tenha estes detalhes prontos: * host, porta e nome do banco de dados * usuário e senha * nomes de esquema, quando o banco de dados usa esquemas * 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 relatórios. Uma Fonte de Dados dá ao Reporter acesso para ler dados usados em Templates e Relatórios. ## Passo a passo *** Acesse **Fontes de Dados** e clique em **Adicionar Fonte de Dados**. Em **Adicionar Fonte de Dados**, informe **Nome da Conexão**, **Tipo de Banco de Dados**, **Host**, **Porta**, **Nome do Banco de Dados**, **Usuário** e **Senha**. Para tipos de banco de dados em que o Console mostra **Esquemas** (atualmente PostgreSQL no seletor), adicione os esquemas que o Reporter deveria inspecionar. Digite um nome de esquema e clique em **Adicionar**, ou pressione **Enter**. Expanda **Configuração de SSL**, ative **Habilitar SSL**, selecione **Modo SSL** e cole o **Certificado CA** se a sua infraestrutura exigir. Expanda **Metadados** para adicionar campos de chave-valor que ajudam os operadores a classificar a conexão. Clique em **Criar**. Uma nova Fonte de Dados ainda não tem resultado de conexão. Execute **Testar Conexão** antes de usá-la em Templates ou Relatórios. ## Guia de campos *** | Campo | O que inserir | Exemplo | | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | | **Nome da Conexão** | Nome obrigatório voltado ao operador. Campo técnico: `configName`. Validação do Console: de 3 a 100 caracteres. | `production-postgres` | | **Tipo de Banco de Dados** | Motor de banco de dados obrigatório. O Console atualmente oferece `POSTGRESQL` e `MONGODB`. Campo técnico: `type`. | `POSTGRESQL` | | **Host** | Endereço obrigatório do servidor de banco de dados, não a URL de uma aplicação. Campo técnico: `host`. | `db.example.com` | | **Porta** | Porta obrigatória do banco de dados. Campo técnico: `port`; o intervalo válido é de 1 a 65535. | `5432` | | **Nome do Banco de Dados** | Nome obrigatório do banco de dados que o Reporter vai consultar. Campo técnico: `databaseName`. | `ledger` | | **Usuário** | Usuário obrigatório do banco de dados. Campo técnico: `username`. | `reporter_readonly` | | **Senha** | Segredo obrigatório ao criar uma Fonte de Dados. Campo técnico: `password`. | Armazenada pelo formulário | | **Esquemas** | Lista opcional de esquemas para os tipos de banco de dados suportados. Armazenada como `metadata.schemas`; as entradas são aparadas, convertidas para minúsculas e deduplicadas. | `public`, `pix`, `transactions` | | **Habilitar SSL** | Toggle opcional de SSL. Quando habilitado, o payload da conexão inclui `ssl`. | Habilitado | | **Modo SSL** | Obrigatório quando o SSL está habilitado. 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 de chave/valor de **Metadados** | Dados opcionais de classificação do operador. Apenas linhas com uma chave não vazia são enviadas. Campo técnico: `metadata`. | `environment = production` | ## Resultado esperado *** A nova Fonte de Dados externa aparece na página **Fontes de Dados** sem resultado de conexão até ser testada. Depois de um teste bem-sucedido, os operadores podem usar os campos dela em Templates e Relatórios. ## Erros comuns e pontos de atenção *** **Host** deveria ser o endereço do servidor de banco de dados, como `db.example.com`, não a URL de uma aplicação ou painel administrativo. Se o banco de dados usa esquemas e o esquema necessário não está listado, os operadores podem não ver as tabelas e campos esperados. Se a infraestrutura exige SSL ou um certificado CA, a conexão pode falhar até que **Configuração de SSL** corresponda a esse requisito. Nomes como `db1` são difíceis de usar com segurança. Prefira nomes que mostrem o ambiente e o propósito, como `production-compliance-readonly`. ## Próximos passos *** * Use [Testar a conexão de uma Fonte de Dados](/pt/products/reporter/console/testing-a-data-source) imediatamente depois da criação. * Use o [Template Builder](/pt/products/reporter/console/template-builder) para usar campos da Fonte de Dados em um Template. * Use [Gerar um Relatório](/pt/products/reporter/console/generating-a-report) depois que o Template e a Fonte de Dados estiverem prontos.