Objetivo
Validar a conectividade antes de os operadores dependerem do Data Source em Templates ou Relatórios. Por exemplo, teste após criar
production-postgres, após uma rotação de senha ou antes de gerar um relatório mensal que dependa de um schema recém-alterado.
Quando usar
Use esta tarefa:
- imediatamente após adicionar um Data Source externo;
- ao revisar um Data Source interno existente antes de usá-lo em um Template ou filtro;
- após editar host, credenciais, schema ou ajustes de SSL;
- antes de gerar Relatórios que dependem da conexão;
- quando nenhuma tabela aparece no navegador de schemas;
- quando a geração de Relatórios falha por erros de conexão ou de schema.
Antes de começar
Confirme:
- o Data Source existe na página Data Sources;
- o host, porta, nome do banco, usuário, schema e ajustes de SSL esperados estão configurados;
- o banco deve estar acessível a partir do Reporter;
- o usuário de banco tem permissão para ler as tabelas necessárias.
Um teste bem-sucedido confirma o acesso naquele momento. Não garante que Relatórios futuros terão sucesso se credenciais, regras de rede ou permissões de banco mudarem depois.
Passo a passo
1
Abra Data Sources
Vá para Data Sources.
2
Encontre a conexão
Localize o card do Data Source que precisa testar.
3
Rode o teste
Clique em Testar Conexão.
4
Espere o resultado
O status muda para Conectando enquanto o Reporter testa a conexão.
5
Leia o resultado
Se o teste tiver sucesso, o status muda para Conectado e a latência é exibida, como
Latency: 45ms. Se falhar, o status muda para Desconectado e uma mensagem de erro aparece.6
Verifique o schema quando conectado
Expanda o card da conexão para ver os schemas, tabelas e campos retornados.
Guia de campos
Ação de teste e campos de resultado
Campos de schema exibidos após o teste
Resultado esperado
O status do Data Source é Conectado, a informação de schema está disponível e os operadores podem usar com segurança os campos no Template Builder e em filtros de relatório.
Erros comuns e pontos de atenção
A conexão tem sucesso mas nenhuma tabela aparece
A conexão tem sucesso mas nenhuma tabela aparece
Verifique nomes de schema e permissões do banco. O usuário do banco pode conectar mas não ter acesso às tabelas necessárias para o reporting.
A conexão falha após editar credenciais
A conexão falha após editar credenciais
Reabra o Data Source e confirme usuário, senha, host, porta e ajustes de SSL.
Testar uma vez e assumir que continua válido
Testar uma vez e assumir que continua válido
Regras de rede, senhas rotacionadas e permissões de banco podem mudar. Refaça o teste quando aparecerem erros de geração.
Próximos passos
- Use o Template Builder depois que schemas e campos ficarem visíveis.
- Use Gerar um Relatório quando o Data Source estiver saudável.
- Use Editar um Data Source se o teste falhar por ajustes errados.
Test connection
Teste uma conexão de Data Source de forma programática.
Validate schema
Valide o acesso de schema a tabelas e campos.