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 integrácia notebooku podporuje zachovanie mapovacieho vzťahu pripojeného prostredia pri synchronizácii s novým pracovným priestorom, čo znamená, že keď commitujete notebook a pripojené prostredie do git repozitára a synchronizujete ho s iným workspace, novo vygenerovaný notebook a prostredie sú prepojené. Táto aktualizácia ovplyvňuje existujúce zápisníky a závislé prostredia, ktoré sú verzionované v gite, fyzické ID pripojeného prostredia v obsahu metadát zápisníka je nahradené logickým ID a zmena sa odráža v diff zobrazení.

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.

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:

Keď commitujete položku zápisníka do Git repozitára, kód zápisníka sa konvertuje do formátu zdrojového kódu namiesto štandardného .ipynb súboru. 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.

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 spravovať zápisníky a ich závislé prostredie v rovnakom pracovnom priestore a používať git na správu verzií notebookov aj environmentálnych položiek. Systém Fabric Git rieši vzťah mapovania pri synchronizácii notebooku a pripojeného prostredia s novými pracovnými priestormi.
• 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ý pipeline dizajnu nasadenia. Staré používateľské rozhranie je možné otvoriť vypnutím 'Pipeline pre nové nasadenie'.
• 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.

   

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

   

   

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.

   

   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.

   

   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.

Súvisiaci obsah

• Spravovanie a spúšťanie poznámkových blokov služby Fabric s verejnými rozhraniami API
• Úvod do integrácie Git
• Úvod do kanálov nasadenia