Operationele gids · Versieontwikkeling

Ontwikkel een Dataset en rapport zonder hun historie te herschrijven.

Gebruik deze werkstroom wanneer Dataset-eigen SQL, bronlineage, schema, kolommen of kolommetadata wijzigen en een bestaand rapport moet beslissen of het nieuwe contract wordt geaccepteerd.

Gebruik deze werkstroom wanneer Dataset-eigen SQL, bronlineage, schema, kolommen of kolommetadata wijzigen en een bestaand rapport moet beslissen of het nieuwe contract wordt geaccepteerd.
Beslisvraag

Behoudt Dataset v3 de kolommen, typen, granulariteit en bronbetekenis die het rapport vereist, of hoort Report v5 aan Dataset v2 vast te blijven totdat het analytische contract opnieuw is ontworpen?

Gebruikte objecten en controles

Dataset, DatasetVersion en DatasetColumn dragen het basisdatacontract. ReportVersion draagt analytische intentie en exacte DatasetVersion-koppelingen. AnalyticsRun legt één uitvoering binnen de huidige governance vast.

Acceptatiestroom

Een nieuwe DatasetVersion verplaatst een bestaande ReportVersion nooit uit zichzelf.

Fout- en gedeeltelijke paden

Een afgewezen kandidaat laat de vorige productiegerichte rapportversie en historische runkoppelingen ongewijzigd.

Geproduceerd bewijs

Versievergelijking, geaccepteerde DatasetVersion-identiteit, onveranderlijke ReportVersion-koppeling, compilatie-/configuratie-/filter-/RLS-hashes en latere AnalyticsRun vormen de vastgelegde keten voor de ondersteunde wijziging.

Beslisvraag

Behoudt Dataset v3 de kolommen, typen, granulariteit en bronbetekenis die het rapport vereist, of hoort Report v5 aan Dataset v2 vast te blijven totdat het analytische contract opnieuw is ontworpen?

Gebruikte objecten en controles

Dataset, DatasetVersion en DatasetColumn dragen het basisdatacontract. ReportVersion draagt analytische intentie en exacte DatasetVersion-koppelingen. AnalyticsRun legt één uitvoering binnen de huidige governance vast.

Dataset-levenscyclus en onveranderlijke DatasetVersion-identiteit

Genormaliseerde SQL, bronlineage, kolommen, typen en bekende profielmetadata

Rapportdimensies, meetwaarden, grafiek, blijvende filters en exacte koppelingen

Servergestuurde compilatie-, rechten-, RLS- en voorvertoningscontext

Acceptatiestroom

Een nieuwe DatasetVersion verplaatst een bestaande ReportVersion nooit uit zichzelf.

  1. De nieuwe DatasetVersion maken

    Sla het gewijzigde Dataset-eigen SQL-/schema-/kolomcontract op met behoud van stabiele Dataset-identiteit en alle eerdere versies.

  2. Exacte versies vergelijken

    Bekijk het genormaliseerde SQL-verschil, bronlineage, toegevoegde/verwijderde/gewijzigde kolommen, typen, nullbaarheid en niet-beschikbare historische metadata.

  3. Analytische compatibiliteit beoordelen

    Bevestig het beoogde detailniveau, dimensies en bronvelden voor elke meetwaarde; leid compatibiliteit niet alleen uit overeenkomende namen af.

  4. Een nieuw rapportconcept openen

    Houd de vorige ReportVersion onveranderlijk en koppel het concept aan de kandidaat-DatasetVersion.

  5. Valideren en compileren

    Bepaal metadata, valideer Query Context en compileer servergestuurde alleen-lezen-SQL voor het huidige ondersteunde dialectpad.

  6. Voorvertonen binnen governance

    Voer een begrensde voorvertoning uit met huidige rechten- en RLS-scope en beoordeel diagnostiek in plaats van alleen schemavalidatie te accepteren.

  7. De geaccepteerde ReportVersion opslaan

    Sla de nieuwe koppeling pas na acceptatie op; volgende AnalyticsRuns verwijzen naar dat exacte paar ReportVersion en DatasetVersion.

Fout- en gedeeltelijke paden

Een afgewezen kandidaat laat de vorige productiegerichte rapportversie en historische runkoppelingen ongewijzigd.

Verwijderd of gewijzigd veld

Compilatie of semantische validatie blokkeert het concept; ontwerp dimensie of meetwaarde opnieuw in plaats van de oude ReportVersion te wijzigen.

Voorvertoning wijkt onverwacht af

Behandel verschuiving van actuele rijen, bronwijziging, filter-/RLS-scope en contractwijziging als afzonderlijke hypothesen; een virtuele DatasetVersion is geen rijsnapshot.

Meervoudige koppeling is gedeeltelijk

Bekijk elke koppelingsdiagnose en bewaar de gedeeltelijke status; certificeer het rapport niet op basis van alleen de geslaagde koppeling.

Geproduceerd bewijs

Versievergelijking, geaccepteerde DatasetVersion-identiteit, onveranderlijke ReportVersion-koppeling, compilatie-/configuratie-/filter-/RLS-hashes en latere AnalyticsRun vormen de vastgelegde keten voor de ondersteunde wijziging.

Report v4 → Dataset v2 · Report v5 → Dataset v2 · Report v6 → Dataset v3

Huidige grens

Vergelijking omvat vastgelegde SQL, schema, kolommen, metadata en lineage; zij verzint geen universele downstream bedrijfsimpact. Analytics-meetwaarden, RLS en rapportrechten blijven buiten het basis-Dataset-aggregaat en exacte historische rijen vereisen een artefact of expliciet gematerialiseerd snapshotcontract.

Volgende stap

Bekijk de versiegrenzen in het productmodel.

Dataset bezit het datacontract; Analytics bezit rapportintentie, meetwaarden, RLS en uitvoering.

Beheerste datasets verkennen