Zdieľať cez


Ovládanie a nasadenie zdrojového poznámkového bloku

Tento článok vysvetľuje, ako fungujú kanály integrácie a nasadenia Git v poznámkových blokoch v službe Microsoft Fabric. Zistite, ako nastaviť pripojenie k vášmu odkladaciemu priestoru, spravovať poznámkové bloky a nasadiť ich v rôznych prostrediach.

Integrácia systému Git v poznámkovom bloke

Poznámkové bloky služby Fabric ponúkajú integráciu Git na ovládanie zdroja so službou Azure DevOps. Vďaka integrácii s aplikáciou Git môžete zálohovať a verzie notebooku, vrátiť sa podľa potreby k predchádzajúcim etapám, spolupracovať alebo pracovať samostatne pomocou vetiev Git a spravovať životný cyklus obsahu notebooku úplne v rámci služby Fabric.

Poznámka

Od októbra 2024 podporuje integrácia systému Notebook git trvalé mapovanie vzťahu pripojeného prostredia pri synchronizácii s novým pracovným priestorom, čo znamená, že keď pripojíte poznámkový blok a pripojené prostredie do odkladacieho priestoru git a synchronizujete ho s iným pracovným priestorom, novovytvorený poznámkový blok a prostredie sa spoja. Táto inovácia bude mať vplyv na existujúce poznámkové bloky a závislé prostredia verzie v systéme git. Fyzické ID pripojeného prostredia v obsahu metaúdajov poznámkového bloku sa nahradí logickým ID. Zmena sa prejaví v zobrazení diff.

Nastavenie pripojenia

V nastaveniach pracovného priestoru môžete jednoducho nastaviť pripojenie do odkladacieho priestoru na potvrdenie a synchronizáciu zmien. Ak chcete nastaviť pripojenie, pozrite si tému Začíname s integráciou systému Git. Po pripojení sa položky vrátane poznámkových blokov zobrazia na ovládacom paneli Zdroj.

Snímka obrazovky ovládacieho panela zdroja pracovného priestoru.

Po úspešnom potvrdení inštancií poznámkového bloku do odkladacieho priestoru systému Git sa v odkladacom priestore zobrazí štruktúra priečinkov poznámkového bloku.

Teraz môžete vykonávať budúce operácie, ako je napríklad vytvorenie žiadosti o prijatie zmien.

Zápisník v Git

Nasledujúci obrázok je príkladom štruktúry súboru každej poznámkovej položky v odkladacom priestore:

Snímka obrazovky zobrazujúca štruktúru súboru v odkladacom priestore Git v notebooku.

Pri potvrdení položky poznámkového bloku do odkladacieho priestoru Git sa poznámkový kód konvertuje na formát zdrojového kódu namiesto štandardného súboru .ipynb. Poznámkový blok V PySpark napríklad konvertuje na súbor notebook-content.py. Tento prístup umožňuje jednoduchšie recenzie kódu pomocou vstavaných funkcií difúz.

V súbore zdroja obsahu položky sa zachovajú a rozlišujú metaúdaje (vrátane predvoleného jazera a pripojeného prostredia), bunky jazyka Markdown a bunky kódu. Tento prístup podporuje presné obnovenie pri synchronizácii späť do pracovného priestoru služby Fabric.

Pri synchronizácii so službou Git nie je zahrnutý výstup notebooku.

Snímka obrazovky znázorňujúca formát obsahu odkladacieho priestoru v odkladacom priestore Git.

Poznámka

  • Súbory v poznámkových blokoch momentálne nie sú viazané na odkladací priestor. Spáchanie týchto súborov sa podporuje v pripravovanom vydaní.
  • Odporúčame, aby ste spravovali poznámkové bloky a ich závislé prostredie v tom istom pracovnom priestore a na ovládanie verzií poznámkových blokov aj položiek prostredia použili systém Fabric Git vzťah pri synchronizovaní poznámkového bloku a pripojeného prostredia k novým pracovným priestorom.
  • Predvolené ID služby lakehouse pretrváva v notebooku pri synchronizácii z odkladacieho priestoru do pracovného priestoru služby Fabric. Ak potvrdíte poznámkový blok s predvoleným jazerom, musíte odkazovať novovytvorenú položku lakehouse manuálne. Ďalšie informácie nájdete v téme Integrácia Git pre Lakehouse.

Poznámkový blok v kanáloch nasadenia

Kanál nasadenia môžete použiť aj na nasadenie kódu poznámkového bloku v rôznych prostrediach, ako je napríklad vývoj, testovanie a produkcia. Táto funkcia vám môže umožniť zefektívniť proces vývoja, zabezpečiť kvalitu a konzistenciu a znížiť manuálne chyby ľahkými operáciami s minimálnym použitím kódu. Pravidlá nasadenia môžete použiť aj na prispôsobenie správania poznámkových blokov pri ich nasadení, ako napríklad zmena predvoleného domova jazier v notebooku.

Poznámka

  • Teraz používate nový návrh kanála nasadenia. Staré používateľské rozhranie je prístupné tak, že vypnete položku Nový kanál nasadenia.
  • Od októbra podporuje poznámkový blok služby Fabric funkciu automatickej väzby, ktorá bude previazať predvolené prostredie lakehouse a pripojené prostredie v rámci toho istého pracovného priestoru pri nasadzovaní do ďalšej fázy. Zmena bude mať vplyv na existujúce poznámkové bloky v kanáli nasadenia.
    • Predvolené prostredie lakehouse a pripojené prostredie (keď sa všetky závislé položky nachádzajú v tom istom pracovnom priestore) sa nahradia novovytvorenými položkami v cieľovom pracovnom priestore. Zmena metaúdajov poznámkového bloku bude v zobrazení diff zvýraznená v ďalšom kole nasadenia.
    • Môžete nastaviť pravidlá nasadenia pre predvolený lakehouse prepísať automaticky zviazané lakehouse.
  • Známy problém: Stav mrazených buniek v notebooku sa počas nasadenia stratí. V súčasnosti pracujeme na súvisiacich úlohách.

Pomocou týchto krokov dokončite nasadenie poznámkového bloku pomocou kanála nasadenia.

  1. Vytvorte nový kanál nasadenia alebo otvorte existujúci kanál nasadenia. (Ďalšie informácie nájdete v téme Začíname s kanálmi nasadenia.)

  2. Priraďte pracovné priestory do rôznych fáz podľa vašich cieľov nasadenia.

  3. Vyberte, zobrazte a porovnajte položky vrátane poznámkových blokov medzi rozličnými fázami, ako je to znázornené v nasledujúcom príklade. Zvýraznený odznak označujúci zmenený počet položiek medzi predchádzajúcou fázou a aktuálnou fázou.

    Snímka obrazovky poznámkového bloku v kanáli nasadenia.

  4. Ak chcete nasadiť poznámkové bloky vo fázach vývoja, testovania a produkcie, vyberte položku Nasadiť .

    Snímka obrazovky výberu položiek a nasadenia.

    Snímka obrazovky nasadenia obsahu pop-up.png.

  5. (Voliteľné.) Ak chcete vytvoriť pravidlá nasadenia pre proces nasadenia, vyberte položku Pravidlá nasadenia. Položka Pravidlá nasadenia je v cieľovej fáze procesu nasadenia.

    Snímka obrazovky položky pravidiel nasadenia.

    Služba Fabric podporuje pri nasadzovaní s pravidlami nasadenia parametrizáciu predvolenej služby lakehouse pre každú inštanciu poznámkového bloku. K dispozícii sú tri možnosti, ako určiť cieľový predvolený lakehouse: Rovnaký so zdrojovým lakehouse, N / A (bez predvoleného lakehouse), a ďalšie lakehouse.

    Snímka obrazovky znázorňujúca nastavenie predvoleného jazera.

    V zabezpečenej izolácii údajov môžete dosiahnuť nastavením tohto pravidla. Predvolený domov lakehouse vášho notebooku sa nahradí službou, ktorú ste zadali ako cieľ počas nasadenia.

    Poznámka

    Pri nastavovaní predvolenej služby lakehouse v pravidlách nasadenia sa musí nachádzať ID služby Lakehouse. ID služby lakehouse môžete získať z prepojenia URL adresy položky. Pravidlá nasadenia majú vyššiu prioritu ako automatická väzba, automaticky zviazaný lakehouse sa prepíše, keď je nakonfigurované pravidlo nasadenia.

  6. Monitorujte stav nasadenia z histórie nasadenia.