> ## 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. # Testar a conexão de uma Fonte de Dados > Verifique se as credenciais e as configurações de rede de uma Fonte de Dados estão corretas antes de usá-la na geração de relatórios regulatórios no módulo Reporter. Use esta página para confirmar que o Reporter consegue acessar uma Fonte de Dados. O teste não lê o schema. Você não pode testar uma Fonte de Dados marcada como **Fornecida pela plataforma**. ## Objetivo *** Valide a conectividade antes que os operadores dependam da Fonte de Dados em Templates ou Relatórios. Por exemplo, teste depois de criar `production-postgres`, depois de uma rotação de senha ou antes de gerar um relatório mensal que depende de um schema alterado recentemente. ## Quando usar *** Use esta tarefa: * quando uma Fonte de Dados mostra **Não testado** ou **Desconectado**. * antes de gerar Relatórios que dependem da conexão. * quando nenhuma tabela aparece no navegador de schema. * quando a geração de Relatório falha por erros de conexão ou schema. ## Antes de começar *** Confirme: * que a Fonte de Dados existe na página **Data Sources**. * que o host, a porta, o nome do banco de dados, o usuário, o schema e as configurações SSL esperados estão configurados. * que o banco de dados deveria estar acessível a partir do Reporter. * que o usuário do banco de dados tem permissão para ler as tabelas necessárias. > [!NOTE] > > Um teste bem-sucedido confirma o acesso naquele momento. Ele não garante que Relatórios futuros terão sucesso se as credenciais, regras de rede ou permissões do banco de dados mudarem depois. ## Passo a passo *** **1. Abrir Fontes de Dados** Acesse **Data Sources**. **2. Localizar a conexão** Localize o card da Fonte de Dados que você precisa testar. **3. Executar o teste** Clique em **Testar Conexão**. **4. Aguardar o resultado** O status muda para **Conectando** enquanto o Reporter testa a conexão. **5. Ler o resultado** Em caso de sucesso, o cartão mostra **Conectado** e a latência. Em caso de falha, o cartão mostra **Desconectado** e o Console mostra o motivo que o Reporter retorna. **6. Verificar o schema** Expanda o cartão para ver as tabelas que o Reporter consegue ler. Quando nenhuma tabela aparece, clique em **Atualizar** para ler o schema de novo. ## Guia de campos *** ### Campos de ação de teste e resultado | Campo ou status | O que significa | Exemplo | | - | - | - | | **Testar Conexão** | Ação no card da Fonte de Dados. O endpoint de teste identifica a conexão selecionada por `dataSourceId`. | Teste `production-postgres`. | | **Conectando** | Status local enquanto a requisição de teste está pendente. Aguarde o resultado final antes de editar ou gerar um Relatório. | **Conectando** | | **Conectado** (rótulo mostrado no Console) | Resultado bem-sucedido mapeado a partir do valor `connected`; a Fonte de Dados pode ser usada naquele momento. | **Conectado** com `Latency: 45ms`. | | **Desconectado** (rótulo mostrado no Console) | Resultado de falha. Um teste malsucedido mapeia o valor `failed` para este rótulo. Verifique host, porta, credenciais, acesso de rede e configurações SSL. | **Desconectado** após `authentication failed`. | | **Não testado** (rótulo mostrado no Console) | O Reporter não tem resultado de teste para a Fonte de Dados. | **Não testado** com `Never checked`. | | Latência | `latencyMs`, retornado em milissegundos para o teste. É um indicativo, não uma garantia da velocidade futura de geração do Relatório. | `45` | | Mensagem de teste | `message` retornado pelo Reporter, geralmente mais útil em caso de falha. Use-a como a primeira pista do que corrigir. | `authentication failed` | ### Campos de schema disponíveis separadamente | Item do schema | O que mostra | Exemplo | | - | - | - | | Tabelas | `tables[].name` retornado pela operação separada de schema. Essas são as tabelas que os operadores podem usar no Template Builder e em filtros de relatório. | `transactions` | | Campos | `tables[].fields[]` dentro de cada tabela. Esses campos podem ser inseridos como variáveis de Template ou usados como filtros de Relatório. | `amount`, `created_at` | | Nenhum schema carregado | Array `tables` vazio ou erro ao carregar o schema. A conexão pode funcionar, mas as permissões de tabela ou os nomes de schema ainda precisam de correção. | Nenhuma tabela encontrada. | ## Resultado esperado *** O cartão mostra **Conectado**. Expanda o cartão para confirmar as tabelas antes de usar os campos dela no Template Builder e em filtros de relatório. ## Erros comuns e pontos de atenção *** > [accordion] A conexão é bem-sucedida, mas nenhuma tabela aparece > > Verifique os nomes de schema e as permissões do banco de dados. O usuário do banco pode conseguir conectar, mas não ter acesso às tabelas necessárias para os relatórios. > [accordion] A conexão falha depois de editar as credenciais > > Reabra a Fonte de Dados e confirme usuário, senha, host, porta e configurações SSL. > [accordion] Testar uma vez e presumir que continua válido > > Regras de rede, senhas rotacionadas e permissões de banco de dados podem mudar. Teste novamente quando surgirem erros de geração. ## Próximos passos *** * Use o [Template Builder](https://docs.lerian.studio/pt/products/reporter/console/template-builder.md) depois que os schemas e campos estiverem visíveis. * Use [Gerar um Relatório](https://docs.lerian.studio/pt/products/reporter/console/generating-a-report.md) depois que a Fonte de Dados estiver saudável. * Use [Editar uma Fonte de Dados](https://docs.lerian.studio/pt/products/reporter/console/editing-a-data-source.md) se o teste falhar porque as configurações estão erradas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.