Como o Reporter alcança os seus dados
O Reporter conecta através de datasources nomeados. Cada um aponta para um banco de dados — por exemplo
midaz_onboarding e midaz_transaction — e os seus templates o referenciam pelo nome, como {{ midaz_onboarding.account.name }}.
Os datasources são configurados quando o Reporter é implantado, não pela sua aplicação. Como eles são declarados depende de como você roda o Reporter:
- Managed (hospedado pela Lerian): a conexão aos seus dados dos produtos Lerian é configurada para você no onboarding — você não define variáveis de datasource.
- Self-hosted: o seu operador declara cada datasource pelas variáveis de ambiente
DATASOURCE_<NAME>_*, incluindo qualquer banco de dados seu (DATASOURCE_EXTERNAL_*).
O que você faz
Independentemente de como é implantado, o seu trabalho como autor de relatórios é o mesmo: construir templates que referenciam os datasources pelo nome. Você também pode adicionar suas próprias fontes de dados — o seu operador as declara no self-hosted, ou elas são integradas para você no managed — e então referenciá-las nos templates como as do Midaz. → Primeiros passos com o Reporter · Construir templates
Somente leitura — aponte para um replica
O Reporter só lê: emite consultas
SELECT para renderizar relatórios e nunca escreve nos seus bancos de dados. Como boa prática, aponte os datasources do Midaz para um read replica (o setup de referência faz isso, com um host midaz-postgres-replica) para manter a carga de relatórios fora do seu primário. Isso é uma recomendação de deployment — o Reporter não força isso.
Veja na Lerian
- A jornada completa de integração: Montando um core banking completo
- O que é o Reporter: O que é o Reporter?
- Configurar datasources e construir templates: Usando o Reporter