Bevarer Dataset v3 de kolonner, typer, den granularitet og kildebetydning, som rapporten kræver – eller bør Report v5 forblive bundet til Dataset v2, indtil analysekontrakten er redesignet?
Driftsguide · Versionsudvikling
Udvikl et Dataset og en rapport uden at omskrive historikken.
Brug dette workflow, når Dataset-ejet SQL, kildelineage, skema, kolonner eller kolonnemetadata ændres, og en eksisterende rapport skal afgøre, om den nye kontrakt skal accepteres.
Dataset, DatasetVersion og DatasetColumn bærer den grundlæggende datakontrakt. ReportVersion bærer den analytiske hensigt og præcise DatasetVersion-bindinger. AnalyticsRun registrerer én udførelse under den aktuelle governance.
En ny DatasetVersion flytter aldrig en eksisterende ReportVersion af sig selv.
En afvist kandidat efterlader den tidligere produktionsvendte rapportversion og dens historiske kørselsbindinger uændrede.
Versionssammenligningen, identiteten på den accepterede DatasetVersion, den uforanderlige ReportVersion-binding, kompilerings-, konfigurations-, filter- og RLS-hashene samt den senere AnalyticsRun udgør den registrerede kæde for den understøttede ændring.
Beslutningsspørgsmål
Bevarer Dataset v3 de kolonner, typer, den granularitet og kildebetydning, som rapporten kræver – eller bør Report v5 forblive bundet til Dataset v2, indtil analysekontrakten er redesignet?
Objekter og kontroller brugt
Dataset, DatasetVersion og DatasetColumn bærer den grundlæggende datakontrakt. ReportVersion bærer den analytiske hensigt og præcise DatasetVersion-bindinger. AnalyticsRun registrerer én udførelse under den aktuelle governance.
Dataset-livscyklus og uforanderlig DatasetVersion-identitet
Normaliseret SQL, kildelineage, kolonner, typer og kendte profilmetadata
Rapportdimensioner, metrics, diagram, vedvarende filtre og præcise bindinger
Serverejet kompilering, tilladelse, RLS og forhåndsvisningskontekst
Acceptflow
En ny DatasetVersion flytter aldrig en eksisterende ReportVersion af sig selv.
-
Opret den nye DatasetVersion
Gem den ændrede Dataset-ejede SQL-, skema- og kolonnekontrakt, mens den stabile Dataset-identitet og alle tidligere versioner bevares.
-
Sammenlign præcise versioner
Gennemgå normaliseret SQL-diff, kildelineage, tilføjede, fjernede eller ændrede kolonner, typer, nullable-tilstand og utilgængelige historiske metadata.
-
Vurder analytisk kompatibilitet
Bekræft den tilsigtede granularitet, dimensionerne og de kildefelter, som hver metric kræver; udled ikke kompatibilitet alene af matchende navne.
-
Åbn et nyt rapportudkast
Bevar den tidligere ReportVersion uændret, og bind udkastet til den foreslåede DatasetVersion.
-
Validér og kompilér
Opløs metadata, validér Query Context, og kompilér serverejet skrivebeskyttet SQL for den aktuelt understøttede dialektvej.
-
Forhåndsvis under governance
Udfør en afgrænset forhåndsvisning med den aktuelle tilladelse og det aktuelle RLS-scope, og gennemgå diagnostik frem for alene at acceptere skemavalideringen.
-
Gem den accepterede ReportVersion
Gem kun den nye binding efter accept; efterfølgende AnalyticsRuns peger på det præcise par af ReportVersion og DatasetVersion.
Fejlveje og delvise forløb
En afvist kandidat efterlader den tidligere produktionsvendte rapportversion og dens historiske kørselsbindinger uændrede.
Fjernet eller ændret felt
Kompilering eller semantisk validering blokerer udkastet; redesign dimensionen eller metric'en frem for at ændre den gamle ReportVersion.
Forhåndsvisningen afviger uventet
Behandl live-rækkedrift, kildeændring, filter-/RLS-scope og kontraktændring som separate hypoteser; en virtuel DatasetVersion er ikke et snapshot af rækker.
Multibinding er delvis
Gennemgå diagnostikken for hver binding, og bevar den delvise tilstand; certificér ikke rapporten alene på baggrund af den vellykkede binding.
Dokumentation, der skabes
Versionssammenligningen, identiteten på den accepterede DatasetVersion, den uforanderlige ReportVersion-binding, kompilerings-, konfigurations-, filter- og RLS-hashene samt den senere AnalyticsRun udgør den registrerede kæde for den understøttede ændring.
Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3
Aktuel afgrænsning
Sammenligningen omfatter registreret SQL, skema, kolonner, metadata og lineage; den opfinder ikke universel downstream-forretningseffekt. Analytics-metrics, RLS og rapporttilladelser ligger uden for det grundlæggende Dataset-aggregat, og præcise historiske rækker kræver et artefakt eller en eksplicit materialiseret snapshotkontrakt.
Næste trin
Gennemgå versionsgrænserne i produktmodellen.
Dataset ejer datakontrakten; Analytics ejer rapportens hensigt, metrics, RLS og udførelse.
Udforsk styrede datasets