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

# Edita una fuente de datos

> Actualiza una fuente de datos existente (cambia credenciales, cambia el host o ajusta la configuración de SSL) sin volver a crear la conexión ni reconfigurar los informes.

Usa esta página para actualizar una fuente de datos editable existente cuando cambian sus datos de acceso a la base de datos.

## Objetivo

***

Mantén una fuente de datos utilizable sin eliminarla y volver a crearla.

Por ejemplo, edita una fuente de datos cuando rota la contraseña de una base de datos externa. Edítala cuando el host cambia después de una migración de infraestructura. Edítala cuando debe verse un esquema nuevo, o cuando cambia la configuración de SSL.

## Cuándo usarlo

***

Usa esta tarea cuando:

* cambiaron las credenciales.
* cambió el host, el puerto o el nombre de la base de datos.
* cambió el acceso a esquemas.
* cambió el modo SSL o las opciones de conexión.
* los metadatos necesitan mejor contexto para el operador.

No puedes editar una fuente de datos marcada como **Provided by the platform** o **Managed by environment**.

Elimina una conexión retirada en lugar de editarla.

## Antes de empezar

***

Confirma qué cambió:

* credenciales: actualiza **Username** o **Password**.
* ubicación de la base de datos: actualiza **Host**, **Port** o **Database Name**.
* visibilidad del esquema: actualiza la lista de esquemas.
* seguridad: actualiza **SSL Mode**.

<Note>
  Una actualización de la fuente de datos afecta la generación futura de informes. Los informes ya generados no cambian.
</Note>

## Paso a paso

***

<Steps>
  <Step title="Abre Data Sources">
    Ve a **Data Sources**.
  </Step>

  <Step title="Encuentra la conexión">
    Ubica la tarjeta de la fuente de datos que necesitas editar.
  </Step>

  <Step title="Abre el formulario de edición">
    Haz clic en los tres puntos verticales (<Icon icon="ellipsis-vertical" />) de la tarjeta y selecciona **Edit**.
  </Step>

  <Step title="Actualiza los campos">
    En **Edit Data Source**, cambia los campos que necesitan corrección.
  </Step>

  <Step title="Guarda los cambios">
    Haz clic en **Save Changes**. La Console guarda los cambios y prueba la conexión.
  </Step>

  <Step title="Lee el resultado de la prueba">
    Cuando la prueba es exitosa, el diálogo se cierra. Cuando falla, los cambios siguen guardados y el diálogo muestra el motivo. Haz clic en **Edit connection** para corregirla, o en **Keep anyway**. Cuando la prueba no se puede ejecutar, el diálogo se cierra y un mensaje indica que no se pudo verificar la conexión.
  </Step>
</Steps>

<Note>
  El campo **Password** aparece vacío por razones de seguridad. Si lo dejas en blanco, se conserva la contraseña actual, a menos que cambies **Database Type**, **Host**, **Port**, **Database Name**, **Username**, **SSL Mode** o **Connection Options**. En ese caso, vuelve a ingresar la contraseña, aunque no haya cambiado.
</Note>

## Guía de campos

***

| Campo | Qué cambiar | Ejemplo |
| - | - | - |
| **Connection Name** | Nombre obligatorio visible para el operador. Campo técnico: `configName`. Hasta 100 caracteres: letras, números, `_` y `-`. No puedes renombrarla mientras las plantillas lean de ella. | `production-postgres-readonly` |
| **Database Type** | Motor de base de datos usado por la conexión: **PostgreSQL** o **MongoDB**. | **PostgreSQL** |
| **Host** | Dirección del servidor de base de datos. Cambiarlo cambia de dónde lee Reporter los datos futuros. | `db-new.example.com` |
| **Port** | Puerto de red de la base de datos. El rango válido es de 1 a 65535. | `5432` |
| **Database Name** | Base de datos que Reporter consulta a través de esta fuente de datos. | `ledger_reporting` |
| **Username** | Usuario de base de datos usado por Reporter. | `reporter_readonly` |
| **Password (leave blank to keep current)** | Déjalo en blanco para conservar la contraseña actual. Obligatorio cuando cambia una configuración de conexión. | Nueva contraseña rotada |
| **Schemas** | Lista opcional de esquemas para PostgreSQL. Las entradas se recortan, se convierten a minúsculas y se deduplican. | `public`, `pix` |
| **SSL Mode** | Comportamiento de SSL. Usa **Disable**, **Require**, **Verify CA** o **Verify Full**. | **Verify Full** |
| **Connection Options** | Opciones de la URI de MongoDB, en **Advanced**. | `authSource=admin` |
| Campos clave/valor de **Metadata** | Datos de clasificación opcionales. Cada fila necesita una clave, y una clave no puede repetirse. | `owner = compliance` |

## Resultado esperado

***

La fuente de datos conserva la configuración actualizada. Después de una prueba exitosa, los operadores pueden confiar en ella para plantillas e informes.

## Errores comunes y puntos de atención

***

<AccordionGroup>
  <Accordion title="Dejar la contraseña en blanco sin querer">
    Dejar **Password** en blanco conserva la contraseña existente solo cuando no cambia ninguna configuración de conexión. Cuando una cambia, vuelve a ingresar la contraseña.
  </Accordion>

  <Accordion title="Cambiar el host sin probar">
    Los cambios de host y puerto pueden apuntar Reporter a una base de datos distinta. Lee el resultado de la prueba que muestra la Console después de guardar.
  </Accordion>

  <Accordion title="Quitar un esquema que usan las plantillas">
    Si una plantilla o un filtro depende de campos de un esquema, quitar ese esquema puede romper la generación futura.
  </Accordion>

  <Accordion title="Editar cuando la conexión debería retirarse">
    Si ningún proceso de informes usa la base de datos, elimina la fuente de datos en lugar de editarla.
  </Accordion>
</AccordionGroup>

## Próximos pasos

***

* Usa [Probar la conexión de una fuente de datos](/es/products/reporter/console/testing-a-data-source) para volver a probar la conexión más adelante.
* Usa [Genera un informe](/es/products/reporter/console/generating-a-report) solo después de que la conexión esté saludable.
* Usa [Elimina una fuente de datos](/es/products/reporter/console/deleting-a-data-source) cuando la conexión esté retirada.
