Lähteen hallinta (esikatselu)

Sovellettavissa:✅ Varasto Microsoft Fabric

Tässä artikkelissa selitetään, miten Git-integraatio- ja käyttöönottoputket toimivat Microsoft Fabric -varastoissa. Lue, miten voit määrittää yhteyden säilöösi, hallita varastojasi ja ottaa ne käyttöön eri ympäristöissä. Fabric Warehousen versionhallinta on tällä hetkellä esikatseluominaisuus.

Voit käyttää sekä Git-integrointi - että käyttöönottoputkia eri skenaarioissa:

  • Käytä Git- ja SQL-tietokantaprojekteja hallitaksesi inkrementaalisia muutoksia, tiimiyhteistyötä ja sitoutumishistoriaa yksittäisissä tietokantaobjekteissa.
  • Käyttöönottojaksojen avulla voit edistää koodimuutoksia erilaisissa esituotanto- ja tuotantoympäristöissä.

Git-integraatio

Microsoft Fabric -GIT-integraatio mahdollistaa kehittäjille kehitysprosessien, työkalujen ja parhaiden käytäntöjen suoraan integroimisen Fabric-alustaan. Se mahdollistaa kehittäjien, jotka kehittävät Fabric:ssa:

  • Varmuuskopioi ja versioi heidän työnsä
  • Palaa edellisiin vaiheisiin tarpeen mukaan
  • Tee yhteistyötä muiden kanssa tai työskentele yksin käyttämällä Git-haaroja
  • Hyödynnä tuttujen lähdekoodinhallintatyökalujen ominaisuuksia Fabric-kohteiden hallintaan

Jos haluat lisätietoja Git-integrointiprosessista, katso:

Yhteyden määrittäminen lähteen hallintaan

Työtilan asetussivulla voit helposti määrittää yhteyden säilöön muutosten vahvistamista ja synkronointia varten.

  1. Yhteyden määrittämiseksi katso Git-integroinnin aloittamisen aloittaminen. Seuraa ohjeita Yhdistääksesi Git-repoon joko Azure DevOps tai GitHub Git-palveluntarjoajana.
  2. Kun yhteys on muodostettu, nimikkeet, mukaan lukien varastot, näkyvät Lähde-ohjauspaneelissa . Kuvakaappaus varaston Fabric-portaalista lähdekoodin asetuksista.
  3. Kun olet yhdistänyt varastoesiintymät Onnistuneesti Git-säilöön, näet varastokansiorakenteen säilössä. Voit nyt suorittaa tulevia toimintoja, kuten luoda pull-pyynnön.

Tietokantaprojektit git-varastolle

Seuraavassa kuvassa on esimerkki säilön kunkin varastokohteen tiedostorakenteesta:

Kuvakaappaus Fabric-portaalista näytevarastoskeemasta.

Kun vahvistat varastokohteen Git-säilöön, varasto muunnetaan lähdekoodimuotoon SQL-tietokantaprojektiksi. SQL-projekti on SQL-objektien paikallinen esitys, joka koostuu yksittäisen tietokannan rakenteen, kuten taulukoiden, tallennettujen toimintosarjojen tai funktioiden, rakenteen. Tietokantaobjektien kansiorakenne on järjestetty skeema-/kohdetyypin mukaan. Kutakin varaston objektia edustaa .sql -tiedosto, joka sisältää sen tietojen määrityskielen (DDL) määrityksen. Varastotaulutiedot ja SQL-turvallisuusominaisuudet eivät sisälly SQL-tietokantaprojektiin.

Jaetut kyselyt on myös varattu säilöön, ja ne perivät nimen, johon ne on tallennettu.

Käyttöönoton putket

Voit myös ottaa varastokoodisi käyttöön käyttöönottojaksoissa eri ympäristöissä, kuten kehityksessä, testauksessa ja tuotannossa. Käyttöönottojaksot eivät paljasta tietokantaprojektia.

Käytä seuraavia vaiheita suorittaaksesi varaston käyttöönoton käyttämällä käyttöönottoputkea.

  1. Luo uusi käyttöönottoputki tai avaa aiemmin luotu käyttöönottoputki. Lisätietoja on kohdassa Käyttöönottoputkien käytön aloittaminen.
  2. Määritä työtilat eri vaiheisiin käyttöönottotavoittedesi mukaan.
  3. Valitse, katso ja vertaa tuotteita, mukaan lukien varastot, eri vaiheiden välillä, kuten seuraavassa esimerkissä on esitetty. Kuvakaappaus kehitys-, testaus- ja tuotantovaiheiden Fabric-portaalista.
  4. Valitse Ota käyttöön , jos haluat ottaa varastot käyttöön kehitys-, testaus- ja tuotantovaiheissa .

Lisätietoja Fabric käyttöönottoputkien prosessista löytyy kohdasta Johdatus käyttöönottoputkiin.

Lähteen hallinnan rajoitukset

Git-integroinnin rajoitukset

  • Tällä hetkellä, jos ALTER TABLE lisäät rajoitteen tai sarakkeen tietokantaprojektiin, käyttöönottoprosessi putoaa ja luo taulukon uudelleen, mikä johtaa datan menetykseen. Taulumääritelmän ja datan säilyttämiseksi harkitse seuraavaa kiertotietä:
    • Luo uusi kopio taulukosta varastossa käyttämällä CREATE TABLE ja , INSERTCREATE TABLE AS SELECT, , tai kloonataulua.
    • Muokkaa uutta taulukkomääritelmää uusilla rajoituksilla tai sarakkeilla halutun mukaan käyttämällä ALTER TABLE.
    • Poista vanha taulukko.
    • Nimeä uusi taulukko uudelleen vanhan taulukon nimeksi käyttämällä sp_rename.
    • Muokkaa vanhan taulukon määritystä SQL-tietokantaprojektissa täsmälleen samalla tavalla. Lähteen hallinnan varaston SQL-tietokantaprojektin ja reaaliaikaisen varaston pitäisi nyt vastata toisiaan.
  • Tällä hetkellä en luo Dataflow Gen2 -tiedostoa, jossa ulostulokohde olisi varastossa. Uusi nimikohde DataflowsStagingWarehouse ilmestyy arkistoon ja estää sitoutumisen ja päivityksen Gitistä.
  • Fabric Git -integraatio ei tue SQL-analytiikan päätelaitetta.
  • Ristiinittäiset riippuvuudet, kohteiden sekvensointi ja synkronointiaukot SQL-analytiikan päätepisteen ja varaston välillä vaikuttavat "haarautumiseen uuteen tai olemassa olevaan työtilaan" ja "siirtymiseen toiseen haaraan" -työnkulkuihin kehityksen ja jatkuvan integraation aikana.

Käyttöönottoputkien rajoitukset

  • Tällä hetkellä, jos ALTER TABLE lisäät rajoitteen tai sarakkeen tietokantaprojektiin, käyttöönottoprosessi putoaa ja luo taulukon uudelleen, mikä johtaa datan menetykseen.
  • Tällä hetkellä en luo Dataflow Gen2 -tiedostoa, jossa ulostulokohde olisi varastossa. Uusi nimikohde DataflowsStagingWarehouse ilmestyy käyttöönottoputkeen ja estää käyttöönoton.
  • Fabric Deployment -putket eivät tue SQL-analytiikan päätepistettä.
  • Ristiinkohtaiset riippuvuudet, esineiden sekvensointi ja synkronointiaukot SQL-analytiikan päätepisteen ja varaston välillä vaikuttavat Fabric Deployment Pipelines -työnkulkuihin.

Skenaariot, joita ei tueta

Seuraavat CI/CD-työnkulut eivät ole virallisesti tuettuja, kun eri työtilojen varastoilla on erilaiset kokoukset. Vaikka nämä operaatiot saattavat onnistua ilman virheitä, ne voivat johtaa metatietovirheisiin.

Kaikissa näissä tilanteissa, jos kolloinnin epäsuhta ilmenee, käytä Python-skriptiä scripts/dw-collation-error-update-tmsl/pbi_interactive.py Fabric toolboxissa GitHub päivittääksesi tietoaineiston (TMSL) kokoelman vastaamaan varaston kokoamista.

Esimerkkitilanne Description Riski
Käyttöönotto pipelines Varastosisällön edistäminen putkivaiheissa (esimerkiksi Dev → Test → Prod), joissa kohdevarasto on luotu eri kokoamalla kuin lähde, ei ole tuettua. Käyttöönotto saattaa onnistua, mutta tietoaineiston kokoamista ei päivitetä vastaamaan kohdevaraston kokoamista.
Laajentuminen uuteen tai olemassa olevaan työtilaan Git-integraation hyödyntäminen laajentumiseen olemassa olevasta työtilasta uuteen tai olemassa olevaan työtilaan, jossa varastolla on eri kokoaminen, ei ole tuettua. Varaston sisältö synkronoidaan, mutta kokoamismetatietoja ei soviteta yhteen.
Haarojen vaihtaminen työtilassa Siirtyminen konttoriin, joka on yhdistetty eri kokouksen varastoon Git-yhdistetyllä työtilalla, ei ole tuettua. Synkronoitu sisältö saattaa siirtää vertailuoletuksia, jotka eivät vastaa nykyistä varastoa.
Muutosten yhdistäminen työtilojen välillä haarojen kautta Git-haarojen yhdistäminen työtiloihin, joissa varastoilla on erilaisia yhdistelmiä, ei tueta. Yhdistäminen saattaa onnistua Git-tasolla, mutta tuloksena oleva tietoaineiston kokoaminen ei heijasta kohdevaraston kokoamista.