Bevarer Dataset v3 kolonnene, typene, granulariteten og kildebetydningen som kreves av rapporten - eller bør Rapport v5 forbli bundet til Dataset v2 inntil analysekontrakten er redesignet?
Driftsveileder · Versjonsutvikling
Utvikle en Dataset og rapporter uten å omskrive historien.
Bruk denne flyten når Dataset-eid SQL, Source-avstamning, skjema, kolonner eller kolonnemetadata endres, og en eksisterende rapport må avgjøre om den nye kontrakten skal godtas.
Dataset, DatasetVersion og DatasetColumn har den grunnleggende datakontrakten. ReportVersion bærer analyseintensjonen og nøyaktige DatasetVersion-bindinger. AnalyticsRun registrerer en kjøring under gjeldende kontroll.
En ny DatasetVersion flytter aldri en eksisterende ReportVersion av seg selv.
En avvist kandidat forlater den forrige produksjonsorienterte rapportversjonen og dens historiske kjøringsbindinger uendret.
Versjonssammenligningen, identiteten til godkjente DatasetVersion, den uforanderlige ReportVersion-bindingen, kompilerings-/konfigurasjons-/filter-/RLS-hashene og senere AnalyticsRun gir den registrerte kjeden til den støttede endringen.
Beslutningsspørsmål
Bevarer Dataset v3 kolonnene, typene, granulariteten og kildebetydningen som kreves av rapporten - eller bør Rapport v5 forbli bundet til Dataset v2 inntil analysekontrakten er redesignet?
Objekter og kontroller brukt
Dataset, DatasetVersion og DatasetColumn har den grunnleggende datakontrakten. ReportVersion bærer analyseintensjonen og nøyaktige DatasetVersion-bindinger. AnalyticsRun registrerer en kjøring under gjeldende kontroll.
Dataset livssyklus og uforanderlig DatasetVersion identitet
Normalisert SQL, source avstamning, kolonner, typer og kjente profilmetadata
Rapportere dimensjoner, mål, diagrammer, vedvarende filtre og eksakte bindinger
Servereid kompilering, tillatelse, RLS og forhåndsvisningskontekst
Akseptflyt
En ny DatasetVersion flytter aldri en eksisterende ReportVersion av seg selv.
-
Opprett den nye DatasetVersion
Lagre den modifiserte Dataset-eide SQL/skjema/kolonnekontrakten mens du beholder den stabile Dataset-identiteten og alle tidligere versjoner.
-
Sammenlign eksakte versjoner
Gjennomgå normalisert SQL diff, source avstamning, lagt til/fjernet/endret kolonner, typer, nulltilstander og utilgjengelige historiske metadata.
-
Vurder analytisk kompatibilitet
Bekreft tiltenkt granularitet, dimensjoner og kildefelt som kreves av hvert mål; ikke utlede kompatibilitet fra samsvarende navn alene.
-
Åpne et nytt rapportutkast
Hold tidligere ReportVersion uendret og bind utkastet til den foreslåtte DatasetVersion.
-
Valider og kompiler
Løs metadata, valider spørringskontekst og kompiler servereid skrivebeskyttet SQL for den gjeldende støttede dialektbanen.
-
Forhåndsvisning under kontroll
Kjør en forhåndsvisning med gjeldende tillatelse og RLS-omfang og gjennomgå diagnostikk i stedet for bare å godta skjemavalidering.
-
Lagre den godkjente ReportVersion
Bevar den nye bindingen først etter godkjenning; senere AnalyticsRun-er peker på det eksakte paret av ReportVersion og DatasetVersion.
Feilveier og delveier
En avvist kandidat forlater den forrige produksjonsorienterte rapportversjonen og dens historiske kjøringsbindinger uendret.
Fjernet eller endret felt
Kompilering eller semantisk validering blokkerer utkastet; redesign dimensjonen eller dimensjonen i stedet for å endre den gamle ReportVersion.
Forhåndsvisningen avviker uventet
Behandle gjeldende radendring, kildeendring, filter/RLS-omfang og kontraktsendring som separate hypoteser; en virtuell DatasetVersion er ikke et øyeblikksbilde av rader.
Multibinding er delvis
Gjennomgå diagnostikken for hver binding og bevar den delvise tilstanden; ikke sertifiser rapporten bare basert på vellykket binding.
Dokumentasjon som skapes
Versjonssammenligningen, identiteten til godkjente DatasetVersion, den uforanderlige ReportVersion-bindingen, kompilerings-/konfigurasjons-/filter-/RLS-hashene og senere AnalyticsRun gir den registrerte kjeden til den støttede endringen.
Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3
Gjeldende avgrensning
Sammenligningen omfatter registrerte SQL, skjema, kolonner, metadata og avstamning; den oppfinner ikke universell nedstrøms forretningseffekt. Analytics-beregninger, RLS og rapporttillatelser er utenfor det grunnleggende Dataset-aggregatet, og nøyaktige historierader krever en artefakt eller eksplisitt materialisert øyeblikksbildekontrakt.
Det neste trinnet
Se gjennom versjonsgrensene i produktmodellen.
Dataset eier datakontrakten; Analytics eier rapportens hensikt, mål, RLS og utførelse.
Utforsk kontrollerte Dataset