> ## 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 uma Fonte de Dados

> Atualize uma Fonte de Dados existente (altere credenciais, troque o host ou ajuste as configurações de SSL) sem recriar a conexão ou reconfigurar relatórios.

Use esta página para atualizar uma Fonte de Dados editável existente quando os detalhes de acesso ao banco de dados dela mudarem.

## Objetivo

***

Mantenha uma Fonte de Dados utilizável sem excluí-la e recriá-la.

Por exemplo, edite uma Fonte de Dados quando a senha de um banco de dados externo é rotacionada. Edite-a quando o host muda depois de uma migração de infraestrutura. Edite-a quando um novo esquema deve ficar visível, ou quando as configurações de SSL mudam.

## Quando usar

***

Use esta tarefa quando:

* as credenciais mudaram.
* o host, a porta ou o nome do banco de dados mudaram.
* o acesso a esquemas mudou.
* o modo SSL ou o certificado CA mudaram.
* os metadados precisam de mais contexto para o operador.

Uma Fonte de Dados pode estar configurada automaticamente para um produto interno da Lerian. Nesse caso, confirme que você deve editá-la pelo Console antes de alterá-la.

Exclua uma conexão desativada em vez de editá-la.

## Antes de começar

***

Confirme o que mudou:

* credenciais: atualize **Usuário** ou **Senha**.
* localização do banco de dados: atualize **Host**, **Porta** ou **Nome do Banco de Dados**.
* visibilidade de esquemas: atualize a lista de esquemas.
* segurança: atualize **Modo SSL** ou **Certificado CA**.

<Note>
  Uma atualização de Fonte de Dados afeta a geração futura de Relatórios. Os Relatórios já gerados permanecem inalterados.
</Note>

## Passo a passo

***

<Steps>
  <Step title="Abrir Fontes de Dados">
    Vá para **Fontes de Dados**.
  </Step>

  <Step title="Encontrar a conexão">
    Localize o cartão da Fonte de Dados que você precisa editar.
  </Step>

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

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

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

  <Step title="Testar a conexão">
    Execute **Testar Conexão** para confirmar que as configurações atualizadas funcionam.
  </Step>
</Steps>

<Note>
  O campo **Senha** aparece vazio por motivos de segurança. Informe um novo valor apenas ao trocar a senha. Deixá-lo em branco mantém a senha atual.
</Note>

## Guia de campos

***

| Campo                                  | O que alterar                                                                                                                        | Exemplo                                   |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- |
| **Nome da Conexão**                    | Nome obrigatório voltado ao operador. Campo técnico: `configName`; a validação do Console é de 3 a 100 caracteres.                   | `production-postgres-readonly`            |
| **Tipo de Banco de Dados**             | Motor de banco de dados usado pela conexão. O Console atualmente oferece `POSTGRESQL` e `MONGODB`.                                   | `POSTGRESQL`                              |
| **Host**                               | Endereço do servidor de banco de dados. Alterá-lo muda de onde o Reporter lê os dados futuros.                                       | `db-new.example.com`                      |
| **Porta**                              | Porta de rede do banco de dados. O intervalo válido é de 1 a 65535.                                                                  | `5432`                                    |
| **Nome do Banco de Dados**             | Banco de dados que o Reporter consulta por meio desta Fonte de Dados.                                                                | `ledger_reporting`                        |
| **Usuário**                            | Usuário do banco de dados 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                    |
| **Esquemas**                           | Lista opcional de esquemas armazenada como `metadata.schemas`; as entradas são aparadas, convertidas para minúsculas e deduplicadas. | `public`, `pix`                           |
| **Habilitar SSL**                      | Toggle das configurações de SSL. Desativar o SSL envia `ssl.mode = disable`.                                                         | Desativado depois de uma migração de rede |
| **Modo SSL**                           | Comportamento do SSL. Use `disable`, `require`, `verify-ca` ou `verify-full`.                                                        | `verify-full`                             |
| **Certificado CA**                     | Obrigatório ao alterar o SSL para `verify-ca` ou `verify-full`. Deixe em branco a menos que esteja substituindo o material de SSL.   | Certificado CA em PEM                     |
| Campos de chave/valor de **Metadados** | Dados opcionais de classificação. Apenas linhas com uma chave não vazia são enviadas.                                                | `owner = compliance`                      |

## Resultado esperado

***

A Fonte de Dados mantém a configuração atualizada. Depois de um teste bem-sucedido, os operadores podem contar com ela em Templates e Relatórios.

## Erros comuns e pontos de atenção

***

<AccordionGroup>
  <Accordion title="Deixar a senha em branco sem intenção">
    Deixar **Senha** em branco preserva a senha existente. Informe um novo valor apenas quando a credencial mudou.
  </Accordion>

  <Accordion title="Alterar o host sem testar">
    Alterações de host e porta podem apontar o Reporter para um banco de dados diferente. Sempre execute **Testar Conexão** depois de salvar.
  </Accordion>

  <Accordion title="Remover um esquema que Templates usam">
    Se um Template ou filtro depende de campos de um esquema, remover esse esquema pode quebrar a geração futura.
  </Accordion>

  <Accordion title="Editar quando a conexão deveria ser desativada">
    Se nenhum processo de relatórios usa o banco de dados, exclua a Fonte de Dados em vez de editá-la.
  </Accordion>
</AccordionGroup>

## Próximos passos

***

* Use [Testar a conexão de uma Fonte de Dados](/pt/products/reporter/console/testing-a-data-source) depois de toda alteração de conexão.
* Use [Gerar um Relatório](/pt/products/reporter/console/generating-a-report) apenas depois que a conexão estiver saudável.
* Use [Excluir uma Fonte de Dados](/pt/products/reporter/console/deleting-a-data-source) quando a conexão for desativada.