Dinaup DocsPG Sync y Power BI
Qué copia PG Sync a tu base PostgreSQL de solo lectura, con qué frecuencia se actualiza cada tabla y cómo se conectan Power BI y .NET a esa base.
PG Sync copia informes de tu Dinaup a una base PostgreSQL de solo lectura, una tabla por informe, y la mantiene al día. Power BI, un cuadro de mando o tu propio código la consultan con SQL. La copia va en un solo sentido: lo que cambies en PostgreSQL no vuelve a Dinaup.
Antes de empezar
- El servicio contratado. Dinaup configura la base, el usuario y el schema al activarlo, y te da el servidor y las credenciales de solo lectura. En dinaup.com, Desarrollo → Sincronización con Postgres elige los informes. Ver Sincronización con Postgres.
- Informes compatibles: los que tienen agrupaciones o cálculos complejos no se copian. Ver Informes por API.
Qué se copia
| Elemento | Cómo queda en PostgreSQL |
|---|---|
| Cada informe elegido | Una tabla en tu schema, con la palabra clave del informe en minúsculas. |
| Cada columna del informe | Una columna con la palabra clave JSON de la columna y el tipo del campo. Los GUID son texto de 36 caracteres. |
id | Clave primaria, el GUID del registro. |
fechaia | La fecha de última actividad del registro, en UTC. |
confirmados | 1 si la fila la escribió la pasada diferencial; 0 si la escribió la copia inmediata de un cambio y aún no se ha verificado. |
| Índices | Uno por cada columna indexada en Dinaup, más fechaia y confirmados. |
| Registros eliminados | Se borran de la tabla. |
La tabla _dinaup_kv no es de datos: su clave estado dice qué tabla se está actualizando, o Fin cuando la pasada termina. Un informe nuevo en la lista crea su tabla en la siguiente pasada y una columna nueva añade su columna; nada se borra de la estructura.
Cuándo se actualiza
En los tres mecanismos, una fila nueva se inserta y una existente se sustituye.
| Mecanismo | Cuándo | Qué escribe |
|---|---|---|
| Lista Asíncronos (Recomendado) | Tras cada escritura, en segundo plano. La operación en Dinaup no espera. | Las filas que acaban de cambiar, con confirmados a 0. |
| Lista Informes Síncronos (Gran impacto en el rendimiento) | Dentro de la propia escritura, antes de responder. Cada escritura tarda más. | Lo mismo, pero el dato está en PostgreSQL cuando la operación termina. |
| Pasada diferencial | Cada 15 minutos aproximadamente. | Las filas con fechaia posterior a la última confirmada, en bloques de 10.000; borra las eliminadas y pone confirmados a 1. |
Un informe no puede estar en las dos listas. Para un dato que tiene que estar en PostgreSQL al terminar la operación, usa la lista síncrona.
Conectar
Power BI o cualquier cliente PostgreSQL se conecta con el servidor, la base, el usuario y la contraseña que te dio Dinaup, y lee las tablas de tu schema. Desde .NET, Dinaup.Database abre esa conexión y ejecuta SQL; para leer por la API en lugar de por SQL, Cliente del SDK.