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

# Editar um Data Source

> Atualize um Data Source existente — mude credenciais, troque o host ou ajuste configurações de SSL sem recriar a conexão.

Use esta página para atualizar um Data Source editável existente quando os dados de acesso ao banco mudarem.

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

Se o Data Source foi configurado automaticamente para um produto interno da Lerian, confirme se ele é editável a partir do Console antes de mudá-lo.

Se a conexão está aposentada e não deve ser mais usada, exclua-a em vez de editar.

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

<Note>
  Uma atualização do Data Source afeta a geração futura de Relatórios. Relatórios já gerados ficam inalterados.
</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 editar.
  </Step>

  <Step title="Abra o formulário de edição">
    Clique nos três pontos verticais (<Icon icon="ellipsis-vertical" />) no card e selecione **Editar**.
  </Step>

  <Step title="Atualize os campos">
    Em **Editar Conexão**, altere os campos que precisam de correção.
  </Step>

  <Step title="Salve as alterações">
    Clique em **Salvar Alterações**.
  </Step>

  <Step title="Teste a conexão">
    Rode **Testar Conexão** para confirmar que os ajustes atualizados funcionam.
  </Step>
</Steps>

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

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

***

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

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

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

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

## Próximos passos

***

* Use [Testar uma conexão de Data Source](/pt/lerian-console/reporter-console/testing-a-data-source) após cada alteração de conexão.
* Use [Gerar um Relatório](/pt/lerian-console/reporter-console/generating-a-report) apenas quando a conexão estiver saudável.
* Use [Excluir um Data Source](/pt/lerian-console/reporter-console/deleting-a-data-source) quando a conexão estiver aposentada.

<Card title="API equivalente" type="tip" horizontal>
  [Endpoint Update connection](/pt/reference/reporter/connections/update-connection)
</Card>