Operatiivinen opas · Versioiden kehitys

Kehitä Datasetia ja raporttia kirjoittamatta niiden historiaa uudelleen.

Käytä työnkulkua, kun Datasetin SQL, lähdepolveutuminen, skeema, sarakkeet tai sarakemetatieto muuttuu ja nykyisen raportin on päätettävä uuden sopimuksen hyväksymisestä.

Käytä työnkulkua, kun Datasetin SQL, lähdepolveutuminen, skeema, sarakkeet tai sarakemetatieto muuttuu ja nykyisen raportin on päätettävä uuden sopimuksen hyväksymisestä.
Päätöskysymys

Säilyttääkö Dataset v3 raportin vaatimat sarakkeet, tyypit, rakeisuuden ja lähdemerkityksen, vai pidetäänkö Report v5 Dataset v2:ssa analytiikkasopimuksen uudistamiseen asti?

Käytetyt objektit ja hallintatoimet

Dataset, DatasetVersion ja DatasetColumn kantavat perusdatasopimuksen. ReportVersion kantaa analytiikkatarkoituksen ja täsmälliset DatasetVersion-sidonnat. AnalyticsRun tallentaa yhden suorituksen nykyisessä hallinnassa.

Hyväksyntävirta

Uusi DatasetVersion ei siirrä nykyistä ReportVersionia itsestään.

Virhe- ja osittaiset polut

Hylätty ehdokas jättää edellisen tuotantoraporttiversion ja sen historialliset suoritussidonnat ennalleen.

Tuotettu todiste

Versiovertailu, hyväksytty DatasetVersion-identiteetti, muuttumaton ReportVersion-sidonta, käännös/määritys/suodatin/RLS-hashit ja myöhempi AnalyticsRun muodostavat tallennetun ketjun tuetulle muutokselle.

Päätöskysymys

Säilyttääkö Dataset v3 raportin vaatimat sarakkeet, tyypit, rakeisuuden ja lähdemerkityksen, vai pidetäänkö Report v5 Dataset v2:ssa analytiikkasopimuksen uudistamiseen asti?

Käytetyt objektit ja hallintatoimet

Dataset, DatasetVersion ja DatasetColumn kantavat perusdatasopimuksen. ReportVersion kantaa analytiikkatarkoituksen ja täsmälliset DatasetVersion-sidonnat. AnalyticsRun tallentaa yhden suorituksen nykyisessä hallinnassa.

Dataset-elinkaari ja muuttumaton DatasetVersion-identiteetti

Normalisoitu SQL, lähdepolveutuminen, sarakkeet, tyypit ja tunnetut profiilimetatiedot

Report-dimensiot, mittarit, kaavio, pysyvät suodattimet ja täsmälliset sidonnat

Palvelimen käännös-, oikeus-, RLS- ja esikatselukonteksti

Hyväksyntävirta

Uusi DatasetVersion ei siirrä nykyistä ReportVersionia itsestään.

  1. Luo uusi DatasetVersion

    Tallenna muuttunut SQL/skeema/sarake-sopimus säilyttäen vakaa Dataset-identiteetti ja kaikki aiemmat versiot.

  2. Vertaa täsmällisiä versioita

    Tarkista normalisoitu SQL-diff, lähdepolveutuminen, lisätyt/poistetut/muuttuneet sarakkeet, tyypit, nullable-tila ja puuttuvat historialliset metatiedot.

  3. Arvioi analyyttinen yhteensopivuus

    Vahvista tarkoitettu rakeisuus, dimensiot ja kunkin mittarin lähdekentät; älä päättele yhteensopivuutta vain samoista nimistä.

  4. Avaa uusi raporttiluonnos

    Pidä edellinen ReportVersion muuttumattomana ja sido luonnos DatasetVersion-ehdokkaaseen.

  5. Validoi ja käännä

    Ratkaise metatiedot, validoi Query Context ja käännä palvelimen vain luku -SQL nykyiselle tuetulle murrepolulle.

  6. Esikatsele hallinnan alaisena

    Suorita rajattu esikatselu nykyisellä oikeus- ja RLS-laajuudella ja arvioi diagnostiikka, älä hyväksy pelkän skeemavalidoinnin perusteella.

  7. Tallenna hyväksytty ReportVersion

    Tallenna uusi sidonta vasta hyväksynnän jälkeen; seuraavat AnalyticsRuns viittaavat tähän täsmälliseen ReportVersion–DatasetVersion-pariin.

Virhe- ja osittaiset polut

Hylätty ehdokas jättää edellisen tuotantoraporttiversion ja sen historialliset suoritussidonnat ennalleen.

Poistettu tai muuttunut kenttä

Käännös tai semanttinen validointi estää luonnoksen; suunnittele dimensio tai mittari uudelleen muuttamatta vanhaa ReportVersionia.

Esikatselu poikkeaa odotetusta

Käsittele aktiivisten rivien muutos, lähdemuutos, suodatin/RLS-laajuus ja sopimusmuutos eri hypoteeseina; virtuaalinen DatasetVersion ei ole rivisnapshot.

Monisidonta on osittainen

Tarkista jokaisen sidonnan diagnostiikka ja säilytä osittainen tila; älä hyväksy raporttia vain onnistuneen sidonnan perusteella.

Tuotettu todiste

Versiovertailu, hyväksytty DatasetVersion-identiteetti, muuttumaton ReportVersion-sidonta, käännös/määritys/suodatin/RLS-hashit ja myöhempi AnalyticsRun muodostavat tallennetun ketjun tuetulle muutokselle.

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

Nykyinen raja

Vertailu kattaa tallennetun SQL:n, skeeman, sarakkeet, metatiedot ja polveutumisen; se ei keksi yleistä alavirran liiketoimintavaikutusta. Analytics-mittarit, RLS ja raporttioikeudet ovat Dataset-aggregaatin ulkopuolella, ja täsmälliset historialliset rivit vaativat artefaktin tai nimenomaisen materialisoidun snapshot-sopimuksen.

Seuraava vaihe

Tarkista tuotemallin versiorajat.

Dataset omistaa datasopimuksen; Analytics omistaa raportin tarkoituksen, mittarit, RLS:n ja suorituksen.

Tutustu hallittuihin Dataseteihin