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
1
Abrir Fontes de Dados
Acesse Fontes de Dados.
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
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.6
Recuperar o schema separadamente
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
Campos de schema disponíveis separadamente
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
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.