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.
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
Campos de schema disponíveis separadamente
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
A conexão é bem-sucedida, mas nenhuma tabela aparece
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.
A conexão falha depois de editar as credenciais
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.
Testar uma vez e presumir que continua válido
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 depois que os schemas e campos estiverem visíveis.
- Use Gerar um Relatório depois que a Fonte de Dados estiver saudável.
- Use Editar uma Fonte de Dados se o teste falhar porque as configurações estão erradas.