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

# Conectar Reporter a Midaz

> Conecta Reporter a Midaz mediante una fuente de datos con nombre, protege la base de datos de origen y verifica la conexión antes de generar tus informes.

Reporter lee los datos de Midaz a través de una **fuente de datos** con nombre. Una plantilla de informe referencia ese nombre y Reporter convierte sus marcadores y filtros en consultas contra la base de datos de origen.

Por ejemplo, una plantilla puede referenciar una cuenta de la fuente de datos `midaz_onboarding`:

```text theme={null}
{{ midaz_onboarding.account.name }}
```

Reporter genera consultas `SELECT` para fuentes PostgreSQL y operaciones `Find` para fuentes MongoDB. Luego renderiza los datos devueltos mediante la plantilla. Reporter no escribe en las bases de datos de origen ni persiste los resultados del informe en Midaz.

## Antes de comenzar

***

Necesitas:

* Acceso de red desde Reporter hasta la base de datos de Midaz.
* Un usuario de base de datos con permisos de solo lectura.
* Preferiblemente, una réplica de lectura para que las cargas de informes no compitan con las cargas del ledger. La configuración de referencia usa el host `midaz-postgres-replica` como ejemplo.
* La base de datos, los esquemas y las tablas que necesitan tus plantillas.

<Warning>
  Reporter genera operaciones de lectura, pero este comportamiento no aplica permisos en la base de datos. Usa credenciales de base de datos de solo lectura. No proporciones a Reporter un usuario que pueda insertar, actualizar, eliminar o cambiar esquemas.
</Warning>

## Elige quién administra la conexión

***

El modelo de despliegue determina quién configura la fuente de datos:

* **Managed (hospedado por Lerian):** la conexión a los datos de tus productos Lerian se configura durante el onboarding. Confirma el nombre y la disponibilidad de la fuente de datos con tu contacto de Lerian antes de crear plantillas.
* **Self-hosted:** tu operador configura la conexión durante el despliegue y administra el acceso de red, las credenciales, los certificados y los permisos de base de datos.

En ambos modelos, los autores de informes referencian la fuente de datos configurada mediante su `configName`.

## Configura una fuente de datos con nombre

***

En un despliegue self-hosted, define la conexión con variables de entorno `DATASOURCE_<NAME>_*`. Configura `DATASOURCE_<NAME>_CONFIG_NAME` con el nombre estable que usarán las plantillas y los filtros.

Por ejemplo, si el `configName` es `midaz_onboarding`, las plantillas referencian `midaz_onboarding` aunque el host o las credenciales de la base de datos cambien posteriormente.

Para fuentes PostgreSQL que exponen más de un esquema, deriva la variable de esquemas del `configName`. Un `configName` con valor `external_db` usa:

```env theme={null}
DATASOURCE_EXTERNAL_DB_SCHEMAS=sales,inventory,reporting
```

Consulta [Configurar fuentes de datos externas](/es/reporter/using-reporter#configurar-fuentes-de-datos-externas) para ver las variables de conexión y ejemplos completos.

## Protege la base de datos de Midaz

***

Usa un rol de base de datos dedicado que solo pueda conectarse y consultar las tablas y los esquemas necesarios. Apunta Reporter a una réplica de lectura si tu topología lo permite. Esto mantiene las consultas de informes fuera de la base de datos primaria, pero la réplica no sustituye las credenciales de solo lectura: aplica ambos controles.

Rota la credencial mediante tu proceso habitual de gestión de secretos. Mantén estable el `configName` para que las plantillas existentes sigan resolviendo la misma fuente de datos.

## Verifica la conexión

***

1. [Lista las fuentes de datos](/es/reference/reporter/list-data-sources) y confirma que aparece el `configName` esperado.
2. Copia el ID de la fuente de datos de la respuesta.
3. [Recupera la fuente de datos](/es/reference/reporter/retrieve-data-source) y confirma que Reporter descubre los esquemas, las tablas y los campos esperados.
4. Crea una plantilla pequeña que referencie un campo conocido y genera un informe para verificar toda la ruta de consulta y renderizado.

La conexión está lista cuando la fuente con nombre está disponible, su estructura descubierta es correcta y el informe de prueba devuelve el valor esperado.

## Solución de problemas

***

### La fuente de datos no está disponible

Comprueba el enrutamiento de red, DNS, la configuración TLS, las credenciales, los permisos de base de datos y el estado de la réplica. Durante la validación de la plantilla, Reporter puede devolver una advertencia `DATA_SOURCE_UNAVAILABLE` en lugar de bloquear la creación de la plantilla. Corrige la conexión antes de depender del resultado del informe.

### El nombre de la fuente es ambiguo

Usa un `configName` descriptivo para cada función de base de datos, como `midaz_onboarding` y `midaz_transaction`. Evita nombres genéricos como `database` o `postgres`, especialmente cuando diferentes fuentes contienen tablas con los mismos nombres. Actualiza la plantilla para referenciar explícitamente la fuente correcta.

## Próximos pasos

***

* [Crea tu primer informe](/es/reporter/reporter-quick-start)
* [Construye plantillas y filtros](/es/reporter/using-reporter)
* [Consulta Reporter en una arquitectura de core banking completa](/es/building-a-complete-core-banking)