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

Tento článok vysvetľuje, ako používať integračné a nasadzovacie pipeline Git s notebookmi v Microsoft Fabric. Naučíte sa, ako pripojiť repozitár, spravovať zdrojový kód notebookov a nasadzovať notebooky naprieč prostrediami.

Predtým, ako začnete

• Pripojte svoj pracovný priestor k Gitu predtým, než dokončíte kroky správy zdrojového kódu zápisníka. Pre návod na nastavenie pozri Začať s integráciou do Gitu.
• Vytvárajte pravidlá nasadzovania zápisníka v cieľovej fáze (napríklad Test alebo Production), nie vo vývoji.
• Na vytvorenie pravidiel nasadenia musíte byť vlastníkom predmetu.

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

Fabric notebooky podporujú integráciu Git s Azure DevOps pre správu zdrojového kódu. Môžete meniť verzie zápisníka, spolupracovať pomocou vetiev a priamo spravovať aktualizácie životného cyklu zápisníka vo Fabric.

Keď commitujete notebook spolu s jeho pripojenými závislosťami (napríklad prostrediami), synchronizácia s iným workspace tieto väzby zachová. Fabric automaticky priradí zápisník k príslušným zdrojom v novom pracovnom priestore.

Na podporu tohto správania Fabric ukladá logické identifikátory pripojených zdrojov do metadát zápisníka. V dôsledku toho môžu Git diffy zobrazovať aktualizácie metadát z fyzických ID na logické ID.

Poznámka

Aktualizácie metadát súvisiace s logickými ID a automatickým väzením sa môžu objaviť v Git diff zobrazeniach aj vtedy, keď sa kód zápisníka nemení.

Nastavenie pripojenia

V nastaveniach pracovného priestoru si nastavte spojenie s vaším repozitárom na commitovanie a synchronizáciu zmien. Pre návod na nastavenie pozri Začať s integráciou do Gitu. Po pripojení sa vaše položky, vrátane zápisníkov, zobrazia v ovládacom paneli Zdrojového kódu .

Po commitovaní inštancií notebookov do Git repozitára môžete vidieť štruktúru priečinkov zápisníka v repozitári.

Teraz môžete vykonávať Git operácie, ako napríklad Create pull request.

Zápisník v Git

Nasledujúci text ukazuje štruktúru súboru pre položku zápisníka v Git repozitári:

.
├── Notebook_1.Notebook/
│   ├── Resources/ (Optional)
│   │   └── builtin/
│   │       ├── large_dataset.parquet
│   │       └── model_output.parquet
│   ├── .platform
│   ├── fs-settings.json (Optional)
│   ├── notebook-content.py
│   └── notebook-settings.json (Optional)
└── Readme.md

.
├── Notebook_2.Notebook/
│   ├── Resources/ (Optional)
│   │   └── builtin/
│   │       ├── large_dataset.parquet
│   │       └── model_output.parquet
│   ├── .platform
│   ├── fs-settings.json (Optional)
│   ├── notebook-content.sql
│   └── notebook-settings.json (Optional)
└── Readme.md

Keď commitujete položku zápisníka, Fabric ju uloží ako zdrojové súbory namiesto štandardného .ipynb súboru. Napríklad zápisník PySpark je uložený ako notebook-content.py. Tento formát je jednoduchší na preštudovanie v Git diffs.

Zdrojový súbor uchováva metadáta zápisníka (vrátane predvoleného lakehouse a pripojeného prostredia), bunky markdownu a kódové bunky ako samostatné sekcie. Fabric používa túto štruktúru na rekonštrukciu zápisníka, keď sa synchronizujete späť do pracovného priestoru.

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

Nasledujúci screenshot ukazuje zdrojový formát v Git repozitári:

Poznámka

Uchovávajte zápisníky a ich závislé prostredia v rovnakom pracovnom priestore a verziu zápisníkov aj environmentálnych položiek v Gite. Fabric mapuje tieto vzťahy pri synchronizácii s novými pracovnými priestormi.

Predvolené Lakehouse ID zostáva v metadátach zápisníka, keď synchronizujete z repozitára do pracovného priestoru Fabric. Ak je to potrebné, manuálne pripútajte zápisník k novej položke v jazernom dome. Ďalšie informácie nájdete v téme Integrácia Git pre Lakehouse.

Nastavenia Notebook Git

Panel nastavení Gitu vám umožňuje ovládať, ako notebooky interagujú so správou zdrojového kódu, vrátane možností viazania Gitu a správy, ktoré súbory priečinka Resources sú zahrnuté v commitoch.

Poznámka

Neupravujte notebook-settings.json v Git repozitári, aby ste kontrolovali automatické priradenie alebo zdroje. Tieto nastavenia spravujte cez stránku s nastaveniami zápisníka.

Automatické viazanie Lakehouse v Gite

Lakehouse Auto-Binding umožňuje Fabric vyriešiť správny predvolený lakehouse pre každý Git-connected workspace. To znižuje manuálne preväzovanie pri presúvaní zošitov medzi vývojovými, testovacími a produkčnými pracovnými priestormi.

Túto funkciu zapnite v nastaveniach zápisníka. Po jeho povolení Fabric vytvorí súbor notebook-settings.json v repozitári a automaticky ho spraví. Neupravujte tento súbor manuálne.

Poznámka

Integrácia Notebook Git podporuje zachovanie väzbového vzťahu medzi notebookmi a ich pripojenými jazernými domami pri synchronizácii medzi pracovnými priestormi. Pri synchronizácii zápisníka s iným pracovným priestorom si môžete vybrať, či sa naviaže na jazerný dom v zdrojovom pracovnom priestore alebo na jazerný dom v novom pracovnom priestore. Pre notebooky už verziované v Gite je fyzické ID pripojeného lakehouse v metadátach notebooku nahradené logickým ID. Táto zmena sa môže objaviť v pohľade Git diff.

Podpora priečinka Notebooks Resources v Gite

Poznámka

Priečinok Environment Resources a integrácia s nasadzovacími pipeline a verejnými API momentálne nie sú podporované.

Vstavaný priečinok Resources je možné uložiť do Gitu, takže skripty a konfiguračné súbory sa verzionujú spolu s notebookom.

Táto funkcia je voliteľná a predvolene vypnutá. Zapni to v nastaveniach zápisníka v sekcii nastavení Gitu. Po jeho zapnutí sa súbory v priečinku Resources zaradia do commitov. Keďže commity majú limit 50 MB , použite .gitignore pravidlá súborov alebo Gitu na vylúčenie veľkých alebo dočasných súborov či priečinkov.

Poznámka

Účinkuje iba zložka .gitignore v koreňovom priečinku zabudovaného zdroja.

Po konfigurácii pravidiel v Gite a commitovaní zmien Fabric uloží pravidlá fs-settings.json do repozitára. Fabric generuje a spravuje tento súbor, aby konfigurácia repozitára zostala konzistentná. Tiež neodporúčame upravovať tento súbor priamo v Git repozitári.

Poznámkový blok v kanáloch nasadenia

Používajte nasadzovacie pipeline na podporu zmien zápisníka naprieč fázami, ako sú vývoj,testovanie a produkcia. Overujte aktualizácie v skorších fázach predtým, než ich povýšite do výroby.

Nasadenie notebooku podporuje automatické priradenie pre predvolené lakehouse a pripojené prostredie, keď sú závislé položky v rovnakom pracovnom priestore. Počas nasadenia môže Fabric tieto závislosti preradiť na zodpovedajúce položky v cieľovom pracovnom priestore. Zmeny metadát sa môžu zobraziť v zobrazení diff.

Ak potrebujete konkrétny predvolený jazerný dom pre cieľovú fázu, nastavte pravidlo nasadenia, ktoré prepíše automatické priradenie.

Nové používateľské rozhranie deployment pipeline sa momentálne používa v tomto článku. Na staré používateľské rozhranie sa dá prepnúť vypnutím pipeline New Deploy.

Poznámka

Známy problém: stav zamrznutých buniek v notebookoch sa počas nasadenia neuchováva.

Použite nasledujúce kroky na nasadenie zápisníkov cez deployment pipeline.

1. Vytvorte nasadovací pipeline alebo otvorte existujúci. Ď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. Vyberajte, prezerajte a porovnávajte predmety, vrátane zápisníkov, medzi úrovňami. Zvýraznený odznak ukazuje počet zmenených položiek medzi predchádzajúcou a aktuálnou fázou.

   

4. Vyberte Nasadiť na propagáciu zápisníkov v štádiách vývoja, testovania a produkcie .

   

5. V okne Nasadiť do tejto fázy si prezrite nové a zmenené položky. Ak chcete pokračovať v nasadení aj v prípade, že jedna alebo viac položiek zlyhá, vyberte Pokračovať v nasadení, ak jedna alebo viac položiek zlyhá.

   Po preštudovaní a potvrdení výberu vyberte Nasadiť.

   

6. (Voliteľné.) Na vytvorenie pravidiel nasadenia vyberte pravidlá nasadenia na cieľovej položke v pipeline (napríklad Test alebo Production).

   Pre všeobecné správanie pravidiel a obmedzenia pozri Vytvoriť pravidlá nasadenia.

   

7. Nakonfigurujte predvolené pravidlo Lakehouse pre každé nasadenie notebooku.

   Toto pravidlo určuje, ku ktorému jazernému domu sa zápisník pripojí v cieľovej fáze po nasadení.

   V paneli Nastaviť pravidlá nasadenia vyberte dlaždicu Default lakehouse .

   Použite rozbaľovacie ponuky From a To na mapovanie predvoleného jazerného domu v zdrojovej fáze na cieľový jazerný dom:

   • To isté platí pre Source Lakehouse: Zachovať rovnaké predvolené nastavenie Lakehouse ako v zdrojovej úrovni.
   • N/A (žiadny predvolený lakehouse): Odstráňte predvolené nastavenie lakehouse v cieľovej fáze.
   • Ostatné: Nahradiť predvolený jazerný dom na zdrojovej úrovni iným jazerným domom v cieľovej úrovni.

   Ak v rozbaľovacom menu To vyberiete Iné, uveďte podrobnosti o cieľovom jazernom dome:

   • Lakehouse ID
   • Názov Lakehouse
   • ID pracovného priestoru Lakehouse

   

   Poznámka

   Pri konfigurácii tohto pravidla je potrebné Lakehouse ID. Lakehouse ID získate z URL položky. Pravidlá nasadenia majú prednosť pred automatickým priradením. Ak je nastavené pravidlo nasadenia, prepíše automaticky viazaný lakehouse.

8. 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