> ## 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. A descoberta do schema é uma operação separada. A Fonte de Dados pode ser uma conexão interna já configurada para um produto Lerian ou uma conexão de banco de dados externa adicionada pelo Console. ## 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: * imediatamente depois de adicionar uma Fonte de Dados externa. * ao verificar uma Fonte de Dados interna existente antes de usá-la em um Template ou filtro. * depois de editar host, credenciais, schema ou configurações SSL. * 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 **Fontes de Dados**. * 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. 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 *** Acesse **Fontes de Dados**. Localize o card da Fonte de Dados que você precisa testar. Clique em **Testar Conexão**. O status muda para **Conectando** enquanto o Reporter testa a conexão. O Reporter retorna o resultado da conexão, uma mensagem segura para exibição e a latência medida. Um teste bem-sucedido retorna `connected`. Um teste malsucedido retorna `failed`. Depois de um teste bem-sucedido, use a operação separada de schema para recuperar schemas, tabelas e campos. ## 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 exibido no Console) | Resultado bem-sucedido mapeado a partir do valor `connected`; a Fonte de Dados está utilizável naquele momento. | **Conectado** com `Latency: 45ms`. | | **Desconectado** (rótulo exibido no Console) | Resultado de falha ou erro de requisição. Um teste malsucedido mapeia o valor `failed` para este rótulo. Verifique host, porta, credenciais, acesso de rede, schema e configurações SSL. | **Desconectado** após `authentication failed`. | | 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 Reporter retornou `connected` para o teste. Recupere o schema separadamente antes de usar os campos dele no Template Builder e em filtros de relatório. ## Erros comuns e pontos de atenção *** 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. Reabra a Fonte de Dados e confirme usuário, senha, host, porta e configurações SSL. 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](/pt/products/reporter/console/template-builder) depois que os schemas e campos estiverem visíveis. * Use [Gerar um Relatório](/pt/products/reporter/console/generating-a-report) depois que a Fonte de Dados estiver saudável. * Use [Editar uma Fonte de Dados](/pt/products/reporter/console/editing-a-data-source) se o teste falhar porque as configurações estão erradas.