> ## 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 pronta para uso 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 as opções de conexão mudaram.
* os metadados precisam de mais contexto para o operador.

Você não pode editar uma Fonte de Dados marcada como **Fornecida pela plataforma** ou **Gerenciado pelo ambiente**.

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

> [!NOTE]
>
> Uma atualização de Fonte de Dados afeta a geração futura de Relatórios. Os Relatórios já gerados permanecem inalterados.

## Passo a passo

***

**1. Abrir Fontes de Dados**

Vá para **Data Sources**.

**2. Encontrar a conexão**

Localize o cartão da Fonte de Dados que você precisa editar.

**3. Abrir o formulário de edição**

Clique nos três pontos verticais () no cartão e selecione **Editar**.

**4. Atualizar os campos**

Em **Editar Data Source**, altere os campos que precisam de correção.

**5. Salvar as alterações**

Clique em **Salvar Alterações**. O Console salva as alterações e testa a conexão.

**6. Ler o resultado do teste**

Quando o teste é bem-sucedido, o diálogo fecha. Quando falha, as alterações continuam salvas e o diálogo mostra o motivo. Clique em **Editar conexão** para corrigi-la, ou em **Manter mesmo assim**. Quando o teste não pode ser executado, o diálogo fecha e uma mensagem informa que a conexão não pôde ser verificada.

> [!NOTE]
>
> O campo **Senha** aparece vazio por motivos de segurança. Deixá-lo em branco mantém a senha atual, a menos que você altere **Tipo de Banco de Dados**, **Host**, **Porta**, **Nome do Banco de Dados**, **Usuário**, **Modo SSL** ou **Opções de Conexão**. Nesse caso, informe a senha de novo, mesmo que ela não tenha mudado.

## Guia de campos

***

| Campo | O que alterar | Exemplo |
| - | - | - |
| **Nome da Conexão** | Nome obrigatório voltado ao operador. Campo técnico: `configName`. Até 100 caracteres: letras, números, `_` e `-`. Você não pode renomeá-la enquanto Templates leem dela. | `production-postgres-readonly` |
| **Tipo de Banco de Dados** | Motor de banco de dados usado pela conexão: **PostgreSQL** ou **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 (deixe em branco para manter a atual)** | Deixe em branco para manter a senha atual. Obrigatória quando uma configuração de conexão muda. | Nova senha rotacionada |
| **Esquemas** | Lista opcional de esquemas para PostgreSQL. As entradas são aparadas, convertidas para minúsculas e deduplicadas. | `public`, `pix` |
| **Modo SSL** | Comportamento do SSL. Use **Desativado**, **Obrigatório**, **Verificar CA** ou **Verificação Completa**. | **Verificação Completa** |
| **Opções de Conexão** | Opções da URI do MongoDB, em **Avançado**. | `authSource=admin` |
| Campos de chave/valor de **Metadados** | Dados opcionais de classificação. Cada linha precisa de uma chave, e uma chave não pode se repetir. | `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

***

> [accordion] Deixar a senha em branco sem intenção
>
> Deixar **Senha** em branco mantém a senha existente apenas quando nenhuma configuração de conexão muda. Quando uma muda, informe a senha de novo.

> [accordion] Alterar o host sem testar
>
> Alterações de host e porta podem apontar o Reporter para um banco de dados diferente. Leia o resultado do teste que o Console mostra depois de salvar.

> [accordion] 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] 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.

## Próximos passos

***

* Use [Testar a conexão de uma Fonte de Dados](https://docs.lerian.studio/pt/products/reporter/console/testing-a-data-source.md) para testar a conexão de novo mais tarde.
* Use [Gerar um Relatório](https://docs.lerian.studio/pt/products/reporter/console/generating-a-report.md) apenas depois que a conexão estiver saudável.
* Use [Excluir uma Fonte de Dados](https://docs.lerian.studio/pt/products/reporter/console/deleting-a-data-source.md) quando a conexão for desativada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.