La sincronización de metadata compara la información disponible con el estado documentado, prepara un preview de cambios y conserva snapshots versionados para trazabilidad. Detecta tablas y columnas creadas, modificadas o eliminadas; revísalas como cambios de metadata, no como decisiones automáticas de gobierno.
La sincronización conecta el Repositorio con el Diccionario técnico. Puede hacer más fácil localizar campos que necesitan documentación o revisar asociaciones existentes, pero no crea por sí sola definiciones de negocio, responsables, relaciones taxonómicas ni controles.
Antes de empezar
Rol. La gestión corresponde al Ingeniero de datos con technical.manage y scope técnico activo para el Repositorio afectado. Un Administrador puede realizarla dentro de toda la empresa. Steward y Owner intervienen cuando un cambio técnico necesita interpretación de negocio dentro de su alcance, pero no pueden ampliar por sí mismos el acceso técnico.
Módulo. Para una operación útil deben estar habilitados Repositorios de datos y Diccionario técnico. Si un módulo se desactiva, GovFrame oculta o limita la funcionalidad y el backend rechaza las operaciones que dependan de él; la desactivación no borra automáticamente los datos ya registrados.
Precondiciones. Debe existir un Repositorio registrado, un conector compatible y acceso autorizado a ese repositorio. Confirma la empresa y el scope técnico antes de comenzar. Trabaja con información de conexión gestionada de forma segura; no copies credenciales, identificadores personales ni detalles de infraestructura a las notas de sincronización.
Recorrido recomendado
- Define el alcance de la revisión. Selecciona el Repositorio autorizado y verifica su contexto de Dominios o Subdominios. Esta asociación facilita la lectura de impacto, pero no reemplaza las asociaciones entre columnas y Atributos.
- Solicita o revisa un preview. Usa el espacio de sincronización para comparar la metadata que se va a incorporar con el contexto ya documentado. El preview es el momento para distinguir tablas y columnas creadas, modificadas o eliminadas y para evitar aceptar cambios por semejanza de nombres.
- Revisa el efecto en el Diccionario técnico. Para cada cambio relevante, comprueba si existe un campo documentado, un Atributo asociado, una Regla de calidad, un Contrato u otra relación registrada. Si no hay una relación, registra la ausencia y coordina su revisión; no infieras una dependencia por compartir Dominio o nombre.
- Conserva la trazabilidad. Los snapshots versionados permiten comparar estados de metadata y seguir la evolución de la fuente. Úsalos como evidencia técnica de lo que se observó; no equivalen a una certificación de calidad ni a una aprobación de negocio.
- Configura o revisa la cadencia disponible. El modelo admite sincronización manual, diaria, semanal o mensual. La agenda efectiva y la automatización dependen de la configuración de la empresa y del entorno de ejecución autorizado. Registrar una frecuencia no permite asumir que exista un job productivo habilitado, que se haya ejecutado una exploración ni que una fuente sea accesible en ese momento.
Ejemplo sintético. Un preview del Repositorio “Operación de pedidos” informa una columna nueva en la tabla de pedidos y una modificación en otra columna. El Ingeniero de datos revisa el snapshot y solicita validación funcional antes de asociar la nueva columna al Atributo “Canal de pedido”. Si no hay evidencia de equivalencia, el campo puede permanecer sin asociación documentada.
Interpretar el resultado
Una sincronización revisada ofrece un historial de snapshots y una vista de cambios técnicos que ayuda a priorizar el trabajo de documentación. En el mapa de relaciones, el detalle técnico permite recorrer el vínculo entre Atributo, Campo del Diccionario y Repositorio cuando ya se ha registrado. La presencia de un Repositorio o una tabla no demuestra por sí misma que todos los campos estén documentados; la falta de un vínculo tampoco debe rellenarse con una relación estimada.
Cuando una Regla de calidad requiera SQL, el recorrido técnico es más estricto: debe existir un campo físico asociado y un dialecto configurado. El resultado de generación de SQL no promete ejecución automática de esa consulta ni una exploración programada de la fuente.
Resultado esperado
Al finalizar, el equipo dispone de un preview revisado o de un snapshot versionado del Repositorio, con cambios técnicos identificados y las decisiones de asociación pendientes o confirmadas según la evidencia disponible. La agenda, si la empresa la configuró y el entorno autorizado la ejecuta, queda expresada en una de las cadencias soportadas sin convertirla en garantía de ejecución.
Límites del estado actual
- La sincronización respeta el aislamiento por empresa, el módulo habilitado, la capacidad y el scope técnico; no permite ampliar acceso a otros Repositorios.
- Los snapshots y agendas son información operativa de metadata. No sustituyen definiciones de negocio, responsabilidades ni decisiones de aprobación.
- La detección de cambios se limita a la metadata documentada de tablas y columnas creada, modificada o eliminada; no debe presentarse como inventario independiente de Riesgos o Controles.
- Los controles de gobierno se representan con objetos existentes, como Reglas de calidad, Políticas o Procedimientos, Workflows, tareas, aprobaciones, clasificaciones o certificaciones, según corresponda.