> ## 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.
# Agrega una fuente de datos
> Configura una conexión de base de datos externa cuando Reporter necesita una fuente de datos que aún no está disponible en Lerian Console para la generación de informes.
Usa esta página para crear una fuente de datos cuando Reporter necesita leer desde una base de datos externa o desde una conexión que aún no está configurada. Si el informe usa datos internos de un producto Lerian, como Midaz o CRM, la fuente de datos ya podría existir.
## Objetivo
***
Configura una conexión externa que las Plantillas y los Informes puedan usar.
Por ejemplo, crea una fuente de datos llamada `production-postgres` que apunte a una base de datos externa de informes, o `compliance-readonly` para un usuario de base de datos de solo lectura que usan los operadores de informes.
## Cuándo usarlo
***
Usa esta tarea cuando:
* la fuente de datos necesaria aún no está disponible en Reporter
* una base de datos nueva debe alimentar informes
* un proceso de informes existente necesita una conexión de solo lectura independiente
* los operadores necesitan esquemas y campos disponibles en Template Builder o en los filtros de informes
Antes de agregar una, revisa si la fuente de datos interna necesaria ya existe. Crear una conexión externa duplicada es innecesario cuando Reporter ya tiene la fuente configurada.
No uses esta tarea para corregir una conexión existente. Usa [Editar una fuente de datos](/es/products/reporter/console/editing-a-data-source) y [Probar la conexión de una fuente de datos](/es/products/reporter/console/testing-a-data-source).
## Antes de empezar
***
Ten a mano estos datos:
* el host, el puerto y el nombre de la base de datos
* el nombre de usuario y la contraseña
* los nombres de esquema, cuando la base de datos usa esquemas
* los requisitos de SSL y el certificado CA, cuando la infraestructura lo exija
* un nombre de conexión claro, como `production-postgres` o `compliance-readonly`
Usa credenciales destinadas al acceso de generación de informes. Una fuente de datos le da a Reporter acceso para leer datos usados en Plantillas e Informes.
## Paso a paso
***
Ve a **Data Sources** y haz clic en **Add Data Source**.
En **Add Data Source**, ingresa **Connection Name**, **Database Type**, **Host**, **Port**, **Database Name**, **Username** y **Password**.
Para los tipos de base de datos en los que la Console muestra **Schemas** (actualmente PostgreSQL en el selector), agrega los esquemas que Reporter debe inspeccionar. Escribe un nombre de esquema y haz clic en **Add**, o presiona **Enter**.
Expande **SSL Configuration**, activa **Enable SSL**, selecciona **SSL Mode** y pega el **CA Certificate** si tu infraestructura lo requiere.
Expande **Metadata** para agregar campos clave-valor que ayuden a los operadores a clasificar la conexión.
Haz clic en **Create**.
Una fuente de datos nueva aún no tiene un resultado de conexión. Ejecuta **Test Connection** antes de usarla en Plantillas o Informes.
## Guía de campos
***
| Campo | Qué ingresar | Ejemplo |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| **Connection Name** | Nombre obligatorio visible para el operador. Campo técnico: `configName`. Validación de la Console: de 3 a 100 caracteres. | `production-postgres` |
| **Database Type** | Motor de base de datos obligatorio. La Console ofrece actualmente `POSTGRESQL` y `MONGODB`. Campo técnico: `type`. | `POSTGRESQL` |
| **Host** | Dirección obligatoria del servidor de base de datos, no la URL de una aplicación. Campo técnico: `host`. | `db.example.com` |
| **Port** | Puerto obligatorio de la base de datos. Campo técnico: `port`; el rango válido es de 1 a 65535. | `5432` |
| **Database Name** | Nombre obligatorio de la base de datos que Reporter consultará. Campo técnico: `databaseName`. | `ledger` |
| **Username** | Usuario obligatorio de la base de datos. Campo técnico: `username`. | `reporter_readonly` |
| **Password** | Secreto obligatorio al crear una fuente de datos. Campo técnico: `password`. | Se almacena mediante el formulario |
| **Schemas** | Lista opcional de esquemas para los tipos de base de datos admitidos. Se almacena como `metadata.schemas`; las entradas se recortan, se convierten a minúsculas y se deduplican. | `public`, `pix`, `transactions` |
| **Enable SSL** | Interruptor opcional de SSL. Cuando está activado, el payload de la conexión incluye `ssl`. | Habilitado |
| **SSL Mode** | Obligatorio cuando SSL está activado. Usa `disable`, `require`, `verify-ca` o `verify-full`. Campo técnico: `ssl.mode`. | `verify-ca` |
| **CA Certificate** | Obligatorio para `verify-ca` y `verify-full`. Campo técnico: `ssl.ca`. | Certificado CA en formato PEM |
| **Metadata** campos clave/valor | Datos de clasificación opcionales para el operador. Solo se envían las filas con una clave no vacía. Campo técnico: `metadata`. | `environment = production` |
## Resultado esperado
***
La nueva fuente de datos externa aparece en la página **Data Sources** sin un resultado de conexión hasta que se prueba. Después de una prueba exitosa, los operadores pueden usar sus campos en Plantillas e Informes.
## Errores comunes y puntos de atención
***
**Host** debe ser la dirección del servidor de base de datos, como `db.example.com`, no la URL de una aplicación o de un panel de administración.
Si la base de datos usa esquemas y el esquema necesario no está en la lista, es posible que los operadores no vean las tablas y los campos esperados.
Si la infraestructura requiere SSL o un certificado CA, la conexión puede fallar hasta que **SSL Configuration** coincida con ese requisito.
Nombres como `db1` son difíciles de usar con seguridad. Prefiere nombres que muestren el entorno y el propósito, como `production-compliance-readonly`.
## Próximos pasos
***
* Usa [Probar la conexión de una fuente de datos](/es/products/reporter/console/testing-a-data-source) inmediatamente después de crearla.
* Usa [Template Builder](/es/products/reporter/console/template-builder) para usar campos de la fuente de datos en una Plantilla.
* Usa [Generar un informe](/es/products/reporter/console/generating-a-report) después de que la Plantilla y la fuente de datos estén listas.