O Dataset v3 preserva o significado das colunas, tipos, granularidade e Sources exigidos pelo relatório — ou deve o Report v5 permanecer fixado ao Dataset v2 até o contrato analítico ser redesenhado?
Guia operacional — Evolução de versões
Evolua um Dataset e um Report sem reescrever o respetivo histórico.
Utilize este fluxo de trabalho quando o SQL, a linhagem de origem, o esquema, as colunas ou os metadados de coluna mudarem e um relatório existente tiver de decidir se aceita o novo contrato.
Dataset, DatasetVersion e DatasetColumn transportam o contrato de dados de base. ReportVersion transporta a intenção analítica e ligações exatas a DatasetVersion. AnalyticsRun regista uma execução sob a governação atual.
Um novo DatasetVersion nunca move um ReportVersion existente por si só.
Um candidato rejeitado deixa inalterada a versão anterior do relatório voltado para a produção e suas vinculações de execução históricas.
A comparação de versões, a identidade DatasetVersion aceite, a ligação ReportVersion imutável, os hashes de compilação, configuração, filtros e RLS e o AnalyticsRun posterior formam a cadeia registada da alteração suportada.
Pergunta de decisão
O Dataset v3 preserva o significado das colunas, tipos, granularidade e Sources exigidos pelo relatório — ou deve o Report v5 permanecer fixado ao Dataset v2 até o contrato analítico ser redesenhado?
Objetos e controlos usados
Dataset, DatasetVersion e DatasetColumn transportam o contrato de dados de base. ReportVersion transporta a intenção analítica e ligações exatas a DatasetVersion. AnalyticsRun regista uma execução sob a governação atual.
Ciclo de vida do conjunto de dados e identidade DatasetVersion imutável
SQL normalizado, linhagem de origem, colunas, tipos e metadados de perfil conhecidos
Dimensões, métricas, gráficos, filtros persistentes e ligações exatas do Report
Compilação controlada pelo servidor, permissões, RLS e contexto de pré-visualização
Fluxo de aceitação
Um novo DatasetVersion nunca move um ReportVersion existente por si só.
-
Crie o novo DatasetVersion
Guarde o contrato alterado de SQL, esquema e colunas, preservando a identidade estável do Dataset e todas as versões anteriores.
-
Compare versões exatas
Revise o SQL diff normalizado, linhagem de origem, colunas adicionadas/removidas/alteradas, tipos, estado anulável e metadados históricos indisponíveis.
-
Avaliar a compatibilidade analítica
Confirme a granularidade pretendida, as dimensões e os campos de origem exigidos por cada métrica; não deduza compatibilidade apenas a partir de nomes coincidentes.
-
Abrir um novo rascunho de relatório
Mantenha o ReportVersion anterior imutável e ligue o rascunho ao candidato DatasetVersion.
-
Validar e compilar
Resolva metadados, valide o Query Context e compile o SQL de propriedade do servidor para o caminho atual do dialeto suportado.
-
Pré-visualização sob governação
Execute uma visualização limitada com permissão atual e âmbito RLS e revise os diagnósticos em vez de aceitar a validação do esquema sozinho.
-
Guardar o ReportVersion aceite
Persista a nova ligação apenas após aceitação; AnalyticsRun posteriores apontam para o par exato de ReportVersion e DatasetVersion.
Falha e caminhos parciais
Um candidato rejeitado deixa inalterada a versão anterior do relatório voltado para a produção e suas vinculações de execução históricas.
Campo removido ou alterado
Compilação ou validação semântica bloqueia o rascunho; redesenhar a dimensão ou métrica em vez de alterar o antigo ReportVersion.
A pré-visualização difere inesperadamente
Trate a deriva da linha ao vivo, a mudança de origem, o âmbito do filtro/RLS e a mudança de contrato como hipóteses separadas; um instantâneo virtual do DatasetVersion não é um instantâneo de linha.
Multi-vinculação é parcial
Revise cada diagnóstico de ligação e preserve o estado parcial; não certifique o relatório apenas da ligação bem-sucedida.
Evidências produzidas
A comparação de versões, a identidade DatasetVersion aceite, a ligação ReportVersion imutável, os hashes de compilação, configuração, filtros e RLS e o AnalyticsRun posterior formam a cadeia registada da alteração suportada.
Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3
Limite actual
A comparação abrange SQL gravado, esquema, colunas, metadados e linhagem; não inventa impacto comercial a jusante universal. Métricas de analítica, RLS e permissões de relatório permanecem fora do agregado de conjunto de dados base e linhas históricas exatas exigem um artefacto ou contrato de instantâneo materializado explícito.
Próximo passo
Reveja os limites da versão no modelo do produto.
O Dataset possui o contrato de dados; o Analytics possui intenção de relatório, métricas, RLS e execução.
Explorar Datasets governados