Objetivo
Manter um Data Source utilizável sem excluí-lo e recriá-lo. Por exemplo, edite um Data Source quando a senha de um banco externo for rotacionada, o host mudar após uma migração de infraestrutura, um novo schema precisar ficar visível ou os ajustes de SSL forem atualizados.
Quando usar
Use esta tarefa quando:
- as credenciais mudaram;
- host, porta ou nome do banco mudaram;
- o acesso a schemas mudou;
- o Modo SSL ou o certificado CA mudou;
- os metadados precisam de mais contexto operacional.
Antes de começar
Confirme o que mudou:
- credenciais: atualize Usuário ou Senha;
- localização do banco: atualize Host, Porta ou Nome do Banco de Dados;
- visibilidade de schemas: atualize a lista de schemas;
- segurança: atualize Modo SSL ou Certificado CA.
Uma atualização do Data Source afeta a geração futura de Relatórios. Relatórios já gerados ficam inalterados.
Passo a passo
O campo Senha aparece vazio por motivos de segurança. Informe um novo valor apenas quando for trocar a senha. Deixar em branco mantém a senha atual.
Guia de campos
| Campo | O que alterar | Exemplo |
|---|---|---|
| Nome da Conexão | Nome obrigatório visível ao operador. Campo técnico: configName; a validação do Console é 3 a 100 caracteres. | production-postgres-readonly |
| Tipo de Banco de Dados | Engine de banco usado pela conexão. O Console atualmente oferece POSTGRESQL e MONGODB. | POSTGRESQL |
| Host | Endereço do servidor de banco. Alterá-lo muda de onde o Reporter lê os dados futuros. | db-new.example.com |
| Porta | Porta de rede do banco. Faixa válida: 1 a 65535. | 5432 |
| Nome do Banco de Dados | Banco que o Reporter consulta por meio deste Data Source. | ledger_reporting |
| Usuário | Usuário de banco usado pelo Reporter. | reporter_readonly |
| Senha (opcional) | Deixe em branco para manter a senha atual. Informe um valor apenas ao substituir a credencial armazenada. | Nova senha rotacionada |
| Schemas | Lista opcional de schemas, armazenada como metadata.schemas; as entradas são aparadas, convertidas para minúsculas e deduplicadas. | public, pix |
| Habilitar SSL | Alterna ajustes de SSL. Desativar SSL envia ssl.mode = disable. | Desativado após migração de rede |
| Modo SSL | Comportamento de SSL. Use disable, require, verify-ca ou verify-full. | verify-full |
| Certificado CA | Obrigatório ao mudar SSL para verify-ca ou verify-full. Deixe em branco a menos que substitua material de SSL. | Certificado CA em PEM |
| Campos chave/valor de Metadata | Dados opcionais de classificação. Apenas linhas com chave não vazia são enviadas. | owner = compliance |
Resultado esperado
O Data Source mantém a configuração atualizada. Após um teste bem-sucedido, os operadores podem confiar nele para Templates e Relatórios.
Erros comuns e pontos de atenção
Deixar a senha em branco sem querer
Deixar a senha em branco sem querer
Deixar Senha em branco preserva a senha existente. Informe um novo valor apenas quando a credencial tiver mudado.
Mudar o host sem testar
Mudar o host sem testar
Mudanças de host e porta podem apontar o Reporter para um banco diferente. Sempre rode Testar Conexão após salvar.
Remover um schema usado por Templates
Remover um schema usado por Templates
Se um Template ou filtro depende de campos de um schema, remover esse schema pode quebrar a geração futura.
Editar quando a conexão deveria ser aposentada
Editar quando a conexão deveria ser aposentada
Se o banco não é mais usado por nenhum processo de reporting, exclua o Data Source em vez de editá-lo.
Próximos passos
- Use Testar uma conexão de Data Source após cada alteração de conexão.
- Use Gerar um Relatório apenas quando a conexão estiver saudável.
- Use Excluir um Data Source quando a conexão estiver aposentada.