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
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.Guia de campos
Ação de teste e campos de resultado
| Campo ou status | O que significa | Exemplo |
|---|---|---|
| Testar Conexão | Ação no card do Data Source. O Console usa o connectionId selecionado para chamar o endpoint de teste. | Testar production-postgres. |
| Conectando | Status local enquanto a requisição de teste está pendente. Espere o resultado final antes de editar ou gerar um Relatório. | Conectando |
| Conectado | Resultado bem-sucedido. O Reporter retornou connected ou success, e o Data Source está utilizável naquele momento. | Conectado com Latency: 45ms. |
| Desconectado | Resultado com falha ou erro na requisição. Verifique host, porta, credenciais, acesso de rede, schema e ajustes de SSL. | Desconectado após authentication failed. |
| Latência | latencyMs, retornado em milissegundos após um teste bem-sucedido. É um sinal, não uma garantia da velocidade futura de geração. | 45 |
| Mensagem do teste | message retornado pelo Reporter, normalmente mais útil em caso de falha. Use como primeira pista do que corrigir. | authentication failed |
Campos de schema exibidos após o teste
| Item de schema | O que mostra | Exemplo |
|---|---|---|
| Tabelas | tables[].name retornado pela validação de schema. 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 |
| Sem schema carregado | Array tables vazio ou erro ao carregar o schema. A conexão pode funcionar, mas permissões de tabela ou nomes de schema ainda precisam de correção. | Nenhuma tabela descoberta. |
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.