¿Dataset v3 conserva las columnas, tipos, granularidad y significado de Source que requiere el informe, o debe Report v5 permanecer fijado a Dataset v2 hasta que se rediseñe el contrato analítico?
Guía operativa · Evolución de versiones
Evolucione un Dataset y un informe sin reescribir su historial.
Utilice este flujo cuando cambien el SQL propiedad del Dataset, el linaje de Source, el esquema, las columnas o sus metadatos y un informe existente deba decidir si acepta el nuevo contrato.
Dataset, DatasetVersion y DatasetColumn contienen el contrato de datos base. ReportVersion contiene la intención analítica y las vinculaciones exactas a DatasetVersion. AnalyticsRun registra una ejecución bajo el gobierno actual.
Una nueva DatasetVersion nunca desplaza por sí sola una ReportVersion existente.
Rechazar una candidata no modifica la versión anterior del informe orientada a producción ni sus vinculaciones históricas de ejecución.
La comparación de versiones, la identidad de DatasetVersion aceptada, la vinculación inmutable de ReportVersion, los hashes de compilación/configuración/filtros/RLS y la AnalyticsRun posterior constituyen la cadena registrada del cambio admitido.
Pregunta de decisión
¿Dataset v3 conserva las columnas, tipos, granularidad y significado de Source que requiere el informe, o debe Report v5 permanecer fijado a Dataset v2 hasta que se rediseñe el contrato analítico?
Objetos y controles utilizados
Dataset, DatasetVersion y DatasetColumn contienen el contrato de datos base. ReportVersion contiene la intención analítica y las vinculaciones exactas a DatasetVersion. AnalyticsRun registra una ejecución bajo el gobierno actual.
Ciclo de vida de Dataset e identidad inmutable de DatasetVersion
SQL normalizado, linaje de Source, columnas, tipos y metadatos de perfil conocidos
Dimensiones y métricas de Report, gráfico, filtros persistentes y vinculaciones exactas
Compilación, permisos, RLS y contexto de vista previa propiedad del servidor
Flujo de aceptación
Una nueva DatasetVersion nunca desplaza por sí sola una ReportVersion existente.
-
Crear la nueva DatasetVersion
Guarde el contrato modificado de SQL/esquema/columnas propiedad del Dataset, preservando la identidad estable del Dataset y todas sus versiones anteriores.
-
Comparar versiones exactas
Revise la diferencia de SQL normalizado, el linaje de Source, las columnas añadidas/eliminadas/modificadas, los tipos, la nulabilidad y los metadatos históricos no disponibles.
-
Evaluar la compatibilidad analítica
Confirme la granularidad prevista, las dimensiones y los campos de Source que requiere cada métrica; no deduzca compatibilidad únicamente porque coincidan los nombres.
-
Abrir un nuevo borrador de informe
Mantenga inmutable la ReportVersion anterior y vincule el borrador a la DatasetVersion candidata.
-
Validar y compilar
Resuelva los metadatos, valide Query Context y compile SQL de solo lectura propiedad del servidor para la ruta de dialecto admitida actualmente.
-
Previsualizar bajo gobierno
Ejecute una vista previa acotada con el alcance actual de permisos y RLS, y revise los diagnósticos en lugar de aceptar únicamente la validación del esquema.
-
Guardar la ReportVersion aceptada
Persista la nueva vinculación solo después de aceptarla; las AnalyticsRuns posteriores apuntan a ese par exacto de ReportVersion y DatasetVersion.
Rutas de fallo y resultado parcial
Rechazar una candidata no modifica la versión anterior del informe orientada a producción ni sus vinculaciones históricas de ejecución.
Campo eliminado o modificado
La compilación o validación semántica bloquea el borrador; rediseñe la dimensión o métrica en lugar de modificar la ReportVersion anterior.
La vista previa difiere de forma inesperada
Trate la deriva de filas activas, el cambio de Source, el alcance de filtros/RLS y el cambio de contrato como hipótesis separadas; una DatasetVersion virtual no es una instantánea de filas.
La vinculación múltiple es parcial
Revise el diagnóstico de cada vinculación y preserve el estado parcial; no certifique el informe basándose únicamente en la vinculación correcta.
Evidencia producida
La comparación de versiones, la identidad de DatasetVersion aceptada, la vinculación inmutable de ReportVersion, los hashes de compilación/configuración/filtros/RLS y la AnalyticsRun posterior constituyen la cadena registrada del cambio admitido.
Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3
Límite actual
La comparación cubre el SQL, esquema, columnas, metadatos y linaje registrados; no inventa un impacto empresarial descendente universal. Las métricas de Analytics, RLS y los permisos de Report permanecen fuera del agregado base de Dataset, y las filas históricas exactas requieren un artefacto o un contrato explícito de instantánea materializada.
Siguiente paso
Revise los límites de versión en el modelo del producto.
Dataset es propietario del contrato de datos; Analytics es propietario de la intención del informe, las métricas, RLS y la ejecución.
Explorar Datasets gobernados