> ## 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.
# Añadir un Data Source
> Configura una conexión externa de base de datos cuando Reporter necesite un Data Source que no esté ya disponible.
Usa esta página para crear un Data Source cuando Reporter necesite leer desde una base de datos externa o desde una conexión que no esté ya configurada. Si el informe usa datos internos de productos Lerian, como Midaz o CRM, el Data Source puede ya existir.
## Objetivo
***
Configurar una conexión externa que Templates y Reports puedan usar.
Por ejemplo, crear un Data Source llamado `production-postgres` que apunte a una base de datos externa de reporting, o `compliance-readonly` para un usuario de base de datos solo-lectura usado por operadores de reporting.
## Cuándo usarlo
***
Usa esta tarea cuando:
* el Data Source requerido no está ya disponible en Reporter;
* una nueva base de datos debe alimentar informes;
* un proceso de informe existente necesita una conexión solo-lectura separada;
* los operadores necesitan que schemas y campos estén disponibles en Template Builder o en filtros de informes.
Antes de añadir uno, comprueba si el Data Source interno requerido ya existe. Crear una conexión externa duplicada es innecesario cuando Reporter ya tiene la fuente configurada.
No uses esta tarea para arreglar una conexión existente. Usa [Editar un Data Source](/es/lerian-console/reporter-console/editing-a-data-source) y [Probar una conexión de Data Source](/es/lerian-console/reporter-console/testing-a-data-source).
## Antes de empezar
***
Ten estos datos a mano:
* host, puerto y nombre de base de datos;
* usuario y contraseña;
* nombres de schemas, cuando la base de datos use schemas;
* requisitos de SSL y certificado CA, cuando los exija la infraestructura;
* un nombre de conexión claro, como `production-postgres` o `compliance-readonly`.
Usa credenciales destinadas al acceso de reporting. Un Data Source da a Reporter acceso para leer datos usados en Templates y Reports.
## Paso a paso
***
Ve a **Data Sources** y haz clic en **Add Data Source**.
En **Add Data Source**, introduce **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), añade los schemas que Reporter debe inspeccionar. Escribe un nombre de schema y haz clic en **Add**, o pulsa **Enter**.
Expande **SSL Configuration**, activa **Enable SSL**, selecciona **SSL Mode** y pega el **CA Certificate** si tu infraestructura lo requiere.
Expande **Metadata** para añadir campos clave-valor que ayuden a los operadores a clasificar la conexión.
Haz clic en **Create**.
El nuevo Data Source aparece con estado **Disconnected**. Ejecuta **Test Connection** antes de usarlo en Templates o Reports.
## Guía de campos
***
| Campo | Qué introducir | Ejemplo |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
| **Connection Name** | Nombre obligatorio visible al operador. Campo técnico: `configName`. Validación en la Console: 3 a 100 caracteres. | `production-postgres` |
| **Database Type** | Motor de base de datos obligatorio. La Console actualmente ofrece `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 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 un Data Source. Campo técnico: `password`. | Se almacena vía el formulario |
| **Schemas** | Lista opcional de schemas para tipos de base de datos soportados. Se guarda como `metadata.schemas`; las entradas se recortan, pasan a minúsculas y se deduplican. | `public`, `pix`, `transactions` |
| **Enable SSL** | Toggle opcional de SSL. Cuando se activa, el payload de conexión incluye `ssl`. | Activado |
| **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 PEM |
| Campos clave/valor de **Metadata** | Datos opcionales de clasificación. Solo se envían filas con clave no vacía. Campo técnico: `metadata`. | `environment = production` |
## Resultado esperado
***
El nuevo Data Source externo aparece en la página **Data Sources** con estado **Disconnected** hasta que se prueba. Tras una prueba exitosa, los operadores pueden usar sus campos en Templates y Reports.
## 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 panel de administración.
Si la base de datos usa schemas y el schema requerido no está listado, los operadores pueden no ver las tablas y 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 entorno y propósito, como `production-compliance-readonly`.
## Pasos siguientes
***
* Usa [Probar una conexión de Data Source](/es/lerian-console/reporter-console/testing-a-data-source) inmediatamente después de la creación.
* Usa el [Template Builder](/es/lerian-console/reporter-console/template-builder) para usar los campos del Data Source en un Template.
* Usa [Generar un Report](/es/lerian-console/reporter-console/generating-a-report) cuando el Template y el Data Source estén listos.
[Endpoint Create connection](/es/reference/reporter/connections/create-connection)