En qué se diferencian los registros de auditoría de las tablas estándar
La tabla de auditoría de Dataverse es una tabla especial del sistema que registra los cambios realizados en otras tablas de su entorno. A diferencia de las tablas estándar, la tabla de auditoría no es compatible con la API de seguimiento de cambios de Dataverse (enlaces delta). En su lugar, Data Mission Sync utiliza un enfoque de marca de agua basado en marcas de tiempo para sincronizar los datos de auditoría.
| 💡 Nota: Para sincronizar los registros de auditoría, debe tener habilitada la auditoría en su entorno de Dataverse. Consulte la documentación de Microsoft sobre la configuración de la auditoría de Dataverse. |
Sincronización basada en marcas de agua
Para la tabla de auditoría, Data Mission Sync realiza un seguimiento del último registro sincronizado utilizando la marca de tiempo createdon como marca de agua. Cada sincronización recupera los registros de auditoría creados después de la última marca de agua, lo que garantiza que no se pierda ninguna entrada de auditoría.
Este enfoque difiere de las tablas estándar que utilizan la API de seguimiento de cambios nativa de Dataverse con enlaces delta. El método de marca de agua es necesario porque:
• La tabla de auditoría es de solo lectura y solo se puede añadir información (los registros nunca se actualizan ni se eliminan).
• La API de seguimiento de cambios no es compatible con la tabla de auditoría.
• La marca de tiempo de creación proporciona un orden fiable para la recuperación incremental.
Procesamiento en dos fases
Los datos de auditoría se procesan en dos fases:
1. Recuperación de entradas de auditoría: se obtienen los registros de auditoría principales, que contienen metadatos sobre cada cambio (quién, cuándo, qué tabla, qué acción).
2. Extracción de detalles de auditoría: se analiza el campo JSON changedata para extraer los cambios detallados a nivel de atributos (valor antiguo, valor nuevo) en una tabla auditdetail independiente.
Tablas de destino para los datos de auditoría
Cuando sincroniza la tabla de auditoría, Data Mission Sync crea dos tablas en su base de datos SQL de Azure:
| Tabla | Descripción |
| audit | Contiene los registros de auditoría principales, incluidos auditid, action, objectid, entity_name, userid, createdon y el JSON sin procesar changedata. |
| auditdetail | Contiene los cambios analizados a nivel de atributo extraídos del JSON changedata. Cada fila representa un campo que ha cambiado, con columnas para el nombre del atributo, el valor antiguo y el valor nuevo. |
Manejo de valores NULL
Data Mission Sync conserva el significado semántico de los valores NULL en los datos de auditoría:
• NULL en oldvalue significa que el campo no se había establecido previamente (el nuevo registro o campo estaba vacío).
• NULL en newvalue significa que el campo se borró.
• Una cadena vacía significa que el campo se estableció explícitamente con un valor vacío.
Esta distinción es importante para realizar un análisis preciso del registro de auditoría y generar informes de cumplimiento.