Bevarar Dataset v3 kolumnerna, typerna, granulariteten och källinnebörden som rapporten kräver – eller ska Report v5 förbli bunden till Dataset v2 tills analyskontraktet har utformats på nytt?
Operativ guide · Versionsutveckling
Utveckla ett Dataset och en rapport utan att skriva om deras historik.
Använd detta flöde när Dataset-ägd SQL, source-lineage, schema, kolumner eller kolumnmetadata ändras och en befintlig rapport måste avgöra om den ska godkänna det nya kontraktet.
Dataset, DatasetVersion och DatasetColumn bär det grundläggande datakontraktet. ReportVersion bär analysavsikten och exakta DatasetVersion-bindningar. AnalyticsRun registrerar en körning under aktuell styrning.
En ny DatasetVersion flyttar aldrig en befintlig ReportVersion av sig själv.
En avvisad kandidat lämnar den tidigare produktionsinriktade rapportversionen och dess historiska körningsbindningar oförändrade.
Versionsjämförelsen, identiteten för godkänd DatasetVersion, den oföränderliga ReportVersion-bindningen, kompilations-/konfigurations-/filter-/RLS-hashar och senare AnalyticsRun ger den registrerade kedjan för den stödda ändringen.
Beslutsfråga
Bevarar Dataset v3 kolumnerna, typerna, granulariteten och källinnebörden som rapporten kräver – eller ska Report v5 förbli bunden till Dataset v2 tills analyskontraktet har utformats på nytt?
Objekt och kontroller som används
Dataset, DatasetVersion och DatasetColumn bär det grundläggande datakontraktet. ReportVersion bär analysavsikten och exakta DatasetVersion-bindningar. AnalyticsRun registrerar en körning under aktuell styrning.
Dataset-livscykel och oföränderlig DatasetVersion-identitet
Normaliserad SQL, source-lineage, kolumner, typer och kända profilmetadata
Rapportdimensioner, mått, diagram, beständiga filter och exakta bindningar
Serverägd kompilering, behörighet, RLS och preview-kontext
Acceptansflöde
En ny DatasetVersion flyttar aldrig en befintlig ReportVersion av sig själv.
-
Skapa den nya DatasetVersion
Spara det ändrade Dataset-ägda SQL-/schema-/kolumnkontraktet och bevara samtidigt den stabila Dataset-identiteten och alla tidigare versioner.
-
Jämför exakta versioner
Granska normaliserad SQL-diff, source-lineage, tillagda/borttagna/ändrade kolumner, typer, nullable-tillstånd och otillgängliga historiska metadata.
-
Utvärdera analytisk kompatibilitet
Bekräfta avsedd granularitet, dimensioner och källfält som krävs av varje mått; härled inte kompatibilitet enbart från matchande namn.
-
Öppna ett nytt rapportutkast
Håll tidigare ReportVersion oföränderlig och bind utkastet till den föreslagna DatasetVersion.
-
Validera och kompilera
Lös metadata, validera Query Context och kompilera serverägd read-only SQL för den aktuella stödda dialektvägen.
-
Förhandsgranska under styrning
Kör en avgränsad preview med aktuellt behörighets- och RLS-omfång och granska diagnostik i stället för att enbart godkänna schemavalidering.
-
Spara den godkända ReportVersion
Bevara den nya bindningen först efter godkännande; efterföljande AnalyticsRuns pekar på exakt det paret av ReportVersion och DatasetVersion.
Felvägar och partiella vägar
En avvisad kandidat lämnar den tidigare produktionsinriktade rapportversionen och dess historiska körningsbindningar oförändrade.
Borttaget eller ändrat fält
Kompilering eller semantisk validering blockerar utkastet; utforma dimensionen eller måttet på nytt i stället för att ändra den gamla ReportVersion.
Preview skiljer sig oväntat
Behandla förändring av aktuella rader, källändring, filter-/RLS-omfång och kontraktsändring som separata hypoteser; en virtuell DatasetVersion är inte en snapshot av rader.
Multi-binding är partiell
Granska diagnostiken för varje bindning och bevara det partiella tillståndet; certifiera inte rapporten utifrån endast den lyckade bindningen.
Evidens som skapas
Versionsjämförelsen, identiteten för godkänd DatasetVersion, den oföränderliga ReportVersion-bindningen, kompilations-/konfigurations-/filter-/RLS-hashar och senare AnalyticsRun ger den registrerade kedjan för den stödda ändringen.
Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3
Aktuell avgränsning
Jämförelsen omfattar registrerad SQL, schema, kolumner, metadata och lineage; den hittar inte på universell nedströms affärspåverkan. Analytics-mått, RLS och rapportbehörigheter ligger utanför det grundläggande Dataset-aggregatet, och exakta historiska rader kräver en artefakt eller ett uttryckligt kontrakt för materialiserad snapshot.
Nästa steg
Granska versionsgränserna i produktmodellen.
Dataset äger datakontraktet; Analytics äger rapportavsikt, mått, RLS och körning.
Utforska styrda Dataset