Muistikirjan lähteen hallinta ja käyttöönotto
Tässä artikkelissa kerrotaan, miten Git-integrointi- ja käyttöönottoputket toimivat Microsoft Fabric -muistikirjoissa. Lue, miten voit muodostaa yhteyden säilöösi, hallita muistikirjoja ja ottaa ne käyttöön eri ympäristöissä.
Notebook Git -integrointi
Fabric-muistikirjat tarjoavat Git-integroinnin lähdehallintaan Azure DevOpsin kanssa. Gatin integroinnin avulla voit varmuuskopioida ja versioida muistikirjasi, palata aiempiin vaiheisiin tarpeen mukaan, tehdä yhteistyötä tai työskennellä yksin Git-haarojen avulla ja hallita muistikirjasi sisällön elinkaarta kokonaan Fabricissa.
Muistiinpano
Aloita lokakuusta 2024, Notebook Git -integrointi tukee liitetyn ympäristön kartoitussuhteen säilymistä, kun synkronoit uuden työtilan, mikä tarkoittaa sitä, että kun vahvistat muistikirjan ja liitit ympäristön yhteen Git-säilöön ja synkronoit sen toiseen työtilaan, uusi muistikirja ja ympäristö sidotaan yhteen. Tämä päivitys vaikuttaa olemassa oleviin muistikirjoihin ja riippuvaisiin ympäristöihin, jotka on versioida gitissä, liitetyn ympäristön fyysinen tunnus muistikirjan metatietosisällössä korvataan Looginen-tunnuksella, muutos heijastuu eronäkymään.
Yhteyden määrittäminen
Työtilan asetuksista voit helposti määrittää yhteyden säilöön vahvistusta ja muutosten synkronointiaksi. Yhteyden määrittämiseksi katso Git-integroinnin aloittamisen aloittaminen. Kun yhteys on muodostettu, kohteet, mukaan lukien muistikirjat, näkyvät Lähde-ohjauspaneelissa.
Kun olet onnistuneesti sitonut muistikirjaesiintymät Git-säilöön, näet muistikirjakansion rakenteen säilössä.
Voit nyt suorittaa tulevia toimintoja, kuten Luo pull-pyyntö.
Muistikirjaesitys Gitissä
Seuraavassa kuvassa on esimerkki jokaisen säilön muistikirjakohteen tiedostorakenteesta:
Kun siirrät muistikirjakohteen Git-säilöön, muistikirjan koodi muunnetaan lähdekoodimuotoon tavallisen .ipynb-tiedoston sijaan. Esimerkiksi PySpark-muistikirja muunnetaan notebook-content.py-tiedostoksi. Tämä lähestymistapa mahdollistaa helpommat koodin tarkistukset käyttämällä sisäisiä eroamistoimintoja.
Kohteen sisältölähdetiedostossa metatiedot (mukaan lukien oletussäilö ja siihen liitetty ympäristö), markdown-solut ja koodisolut säilytetään ja erotetaan toisistaan. Tämä lähestymistapa tukee tarkkaa palautustapaa, kun synkronoit takaisin Fabric-työtilaan.
Muistikirjan solun tulos ei sisälly, kun synkronoidaan Gitiin.
Muistiinpano
- Tällä hetkellä muistikirjaresurssien tiedostoja ei ole varattu säilöön. Näiden tiedostojen vahvistamista tuetaan tulevassa versiossa.
- Suosittelemme, että hallitset muistikirjoja ja niiden riippuvaista ympäristöä samassa työtilassa ja käytät Git-kirjastoa sekä muistikirjan että ympäristön kohteiden versionhallintaan. Fabric Git -järjestelmä hoitaa kartoitussuhteen synkronoidessaan muistikirjaa ja liitettyä ympäristöä uusiin työtiloihin.
- Oletus lakehouse ID säilyy muistikirjassa, kun synkronoit säilöstä Fabric-työtilaan. Jos lähetät muistikirjan, jossa on oletus lakehouse, sinun on viitattava juuri luotuun Lakehouse-kohteeseen manuaalisesti. Lisätietoja on kohdassa Lakehouse Git -integrointi.
Muistikirja käyttöönottoputkissa
Voit myös käyttää käyttöönottoputkea ottaaksesi muistikirjakoodisi käyttöön eri ympäristöissä, kuten kehityksessä, testauksessa ja tuotannossa. Tämän ominaisuuden avulla voit virtaviivaistaa kehitysprosessiasi, varmistaa laadun ja yhdenmukaisuuden sekä vähentää manuaalisia virheitä kevyen vähäkoodisen toiminnon avulla. Käyttöönottosääntöjen avulla voit myös mukauttaa muistikirjojen toimintaa, kun ne otetaan käyttöön, kuten muuttaa muistikirjan oletusjärvitaloa.
Muistiinpano
- Käytät nyt käyttöönottoputken uutta rakennetta. Vanhaa käyttöliittymää voi käyttää poistamalla käytöstä "Uusi käyttöönottoputki".
- Lokakuusta alkaen Fabric-muistikirja tukee automaattista sidontaominaisuutta, joka sitoo oletus lakehouse-ympäristön ja kiinnitetyn ympäristön samaan työtilaan, kun otetaan käyttöön seuraavassa vaiheessa. Muutoksella on vaikutuksia olemassa oleviin muistikirjoihin käyttöönottoputkessa.
- Oletussäilö ja liitetty ympäristö (kun kaikki riippuvaiset kohteet ovat samassa työtilassa) korvataan uusilla luoduilla kohteilla kohdetyötilassa. Muistikirjan metatietojen muutos korostetaan eronäkymässä käyttöönoton seuraavalla kierroksella.
- Voit määrittää oletus lakehousen käyttöönottosäännöt ohittamaan automaattisesti sidotun lakehousen.
- Tunnettu ongelma: Muistikirjassa oleva jäädytetyn solun tila menetetään käyttöönoton aikana. Käsittelemme parhaillaan aiheeseen liittyviä tehtäviä.
Suorita muistikirjasi käyttöönotto käyttöönottoputkella noudattamalla seuraavia vaiheita.
Luo uusi käyttöönottoputki tai avaa aiemmin luotu käyttöönottoputki. (Lisätietoja on ohjeaiheessa Käyttöönottoputkien käytön aloittaminen.)
Määritä työtilat eri vaiheisiin käyttöönottotavoittedesi mukaan.
Valitse, tarkastele ja vertaa kohteita, mukaan lukien muistikirjat, eri vaiheiden välillä, kuten seuraavassa esimerkissä näytetään. Korostettu merkki, joka ilmaisee muutetun kohteen määrän edellisen vaiheen ja nykyisen vaiheen välillä.
Valitse Ota käyttöön , jotta voit ottaa muistikirjasi käyttöön kehitys-, testi- ja tuotantovaiheissa.
(Valinnainen.) Voit valita käyttöönottosäännöt käyttöönottoprosessin käyttöönottosääntöjen luomiseksi. Käyttöönottosääntöjen syöte on käyttöönottoprosessin kohdevaiheessa.
Fabric tukee oletus lakehousen parametrisointia jokaiselle muistikirjaesiintymälle käyttöönottosääntöjen käyttöönoton yhteydessä. On olemassa kolme vaihtoehtoa, joilla voit määrittää kohteen oletus lakehouse: Sama source Lakehouse, N/A(ei oletus lakehouse) ja muut Lakehouse.
Voit saavuttaa suojatun tietojen eristämisen määrittämällä tämän säännön. Muistikirjasi oletus lakehouse korvataan sillä, jonka määritit kohteeksi käyttöönoton aikana.
Muistiinpano
Lakehouse-tunnuksella on oltava oletusarvoinen lakehouse-tunnus käyttöönottosäännöissä. Voit hakea Lakehouse-tunnuksen kohteen URL-linkistä. Käyttöönottosäännöillä on suurempi prioriteetti kuin automaattisella sidonnalla, automaattisesti sidottu Lakehouse korvataan, kun käyttöönottosääntö on määritetty.
Valvo käyttöönoton tilaa käyttöönottohistoriasta.
