Skip to main content
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:
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.
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.

​
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:
Consulta 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 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 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