Skip to main content
Reporter lee los datos de Midaz mediante una fuente de datos con nombre. Una plantilla de informe hace referencia a ese nombre, y Reporter convierte sus marcadores de posición y filtros en consultas contra la base de datos de origen. Por ejemplo, una plantilla puede hacer referencia a una cuenta de la fuente de datos midaz_onboarding:
Reporter genera consultas SELECT para fuentes de PostgreSQL y operaciones Find para fuentes de MongoDB. Luego renderiza los datos obtenidos mediante la plantilla. Reporter no escribe de vuelta en las bases de datos de origen ni almacena los resultados de los informes en Midaz.

​
Antes de empezar

Necesitas lo siguiente:
  • Acceso de red de Reporter a 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 trabajo de los informes no compitan con las 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 impone los permisos de la base de datos. Usa credenciales de base de datos de solo lectura. No le des a Reporter un usuario que pueda insertar, actualizar, eliminar o modificar esquemas.

​
Elige quién gestiona la conexión

Tu modelo de despliegue determina quién configura la fuente de datos:
  • Gestionado (alojado por Lerian): el equipo de onboarding configura la conexión con los datos de tu producto Lerian. Confirma el nombre y la disponibilidad de la fuente de datos con tu contacto de Lerian antes de construir plantillas.
  • Autoalojado, de un solo tenant: tu operador puede establecer la conexión al inicio con variables DATASOURCE_<NAME>_* y es responsable de su acceso de red, credenciales, certificados y permisos de base de datos.
  • Autoalojado, multi-tenant: tu operador crea y gestiona las fuentes de datos de cada tenant mediante la API de Reporter. Establecerlas al inicio con DATASOURCE_* no es la vía de configuración multi-tenant.
En todos los modelos, los autores de informes hacen referencia a la fuente de datos configurada mediante su configName.

​
Configura una fuente de datos con nombre

En un despliegue autoalojado de un solo tenant, define la conexión con variables de entorno DATASOURCE_<NAME>_*. Establece DATASOURCE_<NAME>_CONFIG_NAME con el nombre estable que usarán las plantillas y los filtros. En los despliegues multi-tenant, crea la fuente de datos mediante la API de Reporter en su lugar. Por ejemplo, si el configName es midaz_onboarding, las plantillas hacen referencia a midaz_onboarding aunque el host o las credenciales de la base de datos cambien más adelante. Para fuentes de PostgreSQL que exponen más de un esquema, deriva la variable de esquema a partir del configName. Un configName de external_db usa:
Consulta Configura fuentes de datos externas para conocer las variables de conexión y ver ejemplos completos.

​
Protege la base de datos de Midaz

Usa un rol de base de datos dedicado que pueda conectarse y seleccionar solo las tablas y los esquemas necesarios. Dirige Reporter hacia una réplica de lectura cuando tu topología lo permita. Esto mantiene las consultas de los informes alejadas de la base de datos principal, 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 el configName estable para que las plantillas existentes sigan resolviendo la misma fuente de datos.

​
Verifica la conexión

  1. Enumera las fuentes de datos y confirma que aparece el configName esperado.
  2. Copia el ID de la fuente de datos de la respuesta.
  3. Obtén la fuente de datos y confirma que Reporter descubre los esquemas, las tablas y los campos esperados.
  4. Crea una plantilla pequeña que haga referencia a un campo conocido y luego 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

Revisa el enrutamiento de red, el DNS, la configuración de TLS, las credenciales, los permisos de la 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 confiar en la salida del informe.

​
El nombre de la fuente es ambiguo

Usa un configName descriptivo por cada rol de base de datos, como midaz_onboarding y midaz_transaction. Evita nombres genéricos como database o postgres, sobre todo cuando distintas fuentes contienen tablas con los mismos nombres. Actualiza la plantilla para que haga referencia a la fuente deseada de forma explícita.

​
Próximos pasos