> ## 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 uma conexão de Data Source

> Verifique se as credenciais e os ajustes de rede de um Data Source estão corretos antes de depender dele para gerar relatórios.

Use esta página para confirmar que o Reporter consegue alcançar um Data Source e carregar seu schema. O Data Source pode ser uma conexão interna já configurada para um produto Lerian ou uma conexão externa adicionada a partir do Console.

## 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.

<Note>
  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.
</Note>

## Passo a passo

***

<Steps>
  <Step title="Abra Data Sources">
    Vá para **Data Sources**.
  </Step>

  <Step title="Encontre a conexão">
    Localize o card do Data Source que precisa testar.
  </Step>

  <Step title="Rode o teste">
    Clique em **Testar Conexão**.
  </Step>

  <Step title="Espere o resultado">
    O status muda para **Conectando** enquanto o Reporter testa a conexão.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Verifique o schema quando conectado">
    Expanda o card da conexão para ver os schemas, tabelas e campos retornados.
  </Step>
</Steps>

## 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

***

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="A conexão falha após editar credenciais">
    Reabra o Data Source e confirme usuário, senha, host, porta e ajustes de SSL.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Próximos passos

***

* Use o [Template Builder](/pt/lerian-console/reporter-console/template-builder) depois que schemas e campos ficarem visíveis.
* Use [Gerar um Relatório](/pt/lerian-console/reporter-console/generating-a-report) quando o Data Source estiver saudável.
* Use [Editar um Data Source](/pt/lerian-console/reporter-console/editing-a-data-source) se o teste falhar por ajustes errados.

<CardGroup cols={2}>
  <Card title="Test connection" icon="code" href="/pt/reference/reporter/connections/test-connection">
    Teste uma conexão de Data Source de forma programática.
  </Card>

  <Card title="Validate schema" icon="code" href="/pt/reference/reporter/connections/validate-schema">
    Valide o acesso de schema a tabelas e campos.
  </Card>
</CardGroup>