Vývoj, spúšťanie a spravovanie poznámkových blokov služby Microsoft Fabric

Poznámkový blok v službe Microsoft Fabric je primárnou položkou kódu na vývoj úloh v službe Apache Spark a experimentov strojového učenia. Ide o webový interaktívny povrch používaný dátovými vedcami a dátovými inžiniermi na písanie kódu, ktorý profituje z bohatých vizualizácií a textu v jazyku Markdown. Tento článok vysvetľuje, ako vyvinúť poznámkové bloky s operáciami bunky s kódom a ako ich spustiť.

Vývoj poznámkových blokov

Poznámkové bloky pozostávajú z buniek, ktoré sú jednotlivými blokmi kódu alebo textu, ktoré možno spustiť nezávisle alebo ako skupina.

Na vývoj poznámkových blokov poskytujeme komplexné operácie:

• Pridanie bunky
• Nastavenie primárneho jazyka
• Používanie viacerých jazykov
• IntelliSense v štýle ide
• Zlomky kódu
• Presunutím myšou vložte úryvky
• Presunutím myšou vložte obrázky
• Formátovanie textovej bunky pomocou tlačidiel panela s nástrojmi
• Operáciu vrátenia zmeny alebo opakovania bunky
• Presunutie bunky
• Odstránenie bunky
• Zbalenie vstupu bunky
• Zbalenie výstupu bunky
• Zabezpečenie výstupu bunky
• Zamknutie alebo zmrazenie bunky
• Obsah poznámkového bloku
• Postupné posúvanie v jazyku Markdown
• Nájsť a nahradiť

Pridanie bunky

Existuje niekoľko spôsobov, ako pridať novú bunku do poznámkového bloku.

1. Ukážte kurzorom myši na medzeru medzi dvomi bunkami a vyberte položku Kód alebo Jazyk Markdown.

2. V režime príkazov použite klávesovú skratku. Stlačením klávesu A vložíte bunku nad aktuálnu bunku. Stlačením tlačidla B vložte bunku pod aktuálnu bunku.

Nastavenie primárneho jazyka

Notebooky služby Fabric v súčasnosti podporujú štyri jazyky Apache Spark:

• PySpark (Python)
• Iskra (Scala)
• Spark SQL
• SparkR

Primárny jazyk pre nové pridané bunky môžete nastaviť z rozbaľovacieho zoznamu v hornom paneli príkazov.

Používanie viacerých jazykov

Zadaním magického príkazu jazyka na začiatku bunky môžete v poznámkovom počítači použiť viacero jazykov. Môžete tiež prepnúť jazyk bunky z nástroja na výber jazyka. Nasledujúca tabuľka obsahuje zoznam magických príkazov na prepínanie jazykov buniek.

Magický príkaz	Jazyk	Popis
%%pyspark	Pytón	Spustite dotaz jazyka Python v kontexte Apache Spark.
%%spark	Scala	Spustite dotaz Scala v kontexte Apache Spark.
%%sql	SparkSQL	Spustite dotaz SparkSQL v kontexte Apache Spark.
%%html	Jazyk Html	Spustite n dotaz HTML v kontexte Apache Spark.
%%sparkr	R	Spustite dotaz R v kontexte Apache Spark.

IntelliSense v štýle ide

Fabric notebooky sú integrované s editorom Monako, aby IDE-štýl IntelliSense do bunky editora. Zvýraznenie syntaxe, značka chyby a automatické dokončovanie kódu pomáhajú rýchlo písať kód a identifikovať problémy.

Funkcie IntelliSense sú na rôznych úrovniach splatnosti pre rôzne jazyky. V nasledujúcej tabuľke je uvedené, čo služba Fabric podporuje:

Jazyky	Zvýraznenie syntaxe	Značka chyby syntaxe	Dokončovanie kódu syntaxe	Dokončovanie kódu premennej	Dokončenie kódu systémovej funkcie	Dokončenie kódu funkcie používateľa	Inteligentná zarážka	Postupné posúvanie kódu
PySpark (Python)	Áno	Áno	Áno	Áno	Áno	Áno	Áno	Áno
Pytón	Áno	Áno	Áno	Áno	Áno	Áno	Áno	Áno
Iskra (Scala)	Áno	Áno	Áno	Áno	Áno	Áno	Áno	Áno
SparkSQL	Áno	Áno	Áno	Áno	Áno	Nie	Áno	Áno
SparkR	Áno	Áno	Áno	Áno	Áno	Áno	Áno	Áno
T-SQL	Áno	Áno	Áno	Nie	Áno	Áno	Áno	Áno

Poznámka

Ak chcete používať dokončenie kódu IntelliSense, musíte mať aktívnu reláciu Apache Spark.

Vylepšenie vývoja v jazyku Python pomocou jazyka Pylance

Pylance, výkonný a feature-bohatý jazyk server, je teraz k dispozícii v notebooku Fabric. Služba Pylance uľahčuje vývoj jazyka Python inteligentnými dokončeniami, lepším detekciou chýb a vylepšenými prehľadmi kódu. Medzi kľúčové vylepšenia patrí inteligentnejšie automatické dokončovanie, vylepšená podpora lambda, návrhy parametrov, vylepšené informácie pri ukázaní, lepšie vykresľovanie docstringu a zvýraznenie chýb. S aplikáciou Pylance sa písanie kódu v jazykoch Python a PySpark stáva rýchlejším, presnejším a efektívnejším.

Zlomky kódu

Poznámkové bloky služby Fabric poskytujú úryvky kódu, ktoré vám pomáhajú jednoducho písať bežne používané vzory kódu, ako napríklad:

• Čítanie údajov ako údajový rámec Apache Spark
• Kreslenie grafov pomocou rozhrania Matplotlib

Úryvky sa zobrazia v klávesových skratkách v štýle rozhrania IDE IntelliSense zmiešane s ďalšími návrhmi. Obsah úryvku kódu sa zarovná s jazykom buniek kódu. Dostupné úryvky môžete zobraziť zadaním úryvku. Ak chcete zobraziť zoznam relevantných úryvkov, môžete tiež zadať ľubovoľné kľúčové slovo. Ak napríklad zadáte text Read (Čítanie), zobrazí sa zoznam úryvkov na čítanie údajov z rôznych zdrojov údajov.

Presunutím myšou vložte úryvky

Použitie presunutia myšou na pohodlné čítanie údajov z prieskumníka Lakehouse. Tu sú podporované viaceré typy súborov. môžete pracovať s textovými súbormi, tabuľkami, obrázkami atď. Môžete buď prejsť na existujúcu bunku, alebo na novú bunku. Poznámkový blok vygeneruje úryvok kódu tak, aby zobrazoval ukážku údajov.

Presunutím myšou vložte obrázky

Pomocou presúvania myšou jednoducho vložte obrázky z prehliadača alebo lokálneho počítača do bunky v jazyku Markdown.

Formátovanie textovej bunky pomocou tlačidiel panela s nástrojmi

Ak chcete dokončiť bežné akcie jazyka Markdown, použite tlačidlá formátu na paneli s nástrojmi textovej bunky.

Zrušiť alebo sčervenanie operácií s bunkou

Vyberte položku Zrušiť alebo Znova, prípadne stlačením klávesov Z alebo Shift + Z odoberiete najnovšie operácie bunky. Môžete vrátiť späť alebo zopakovať až 10 najnovších operácií historických buniek.

Podporované operácie s bunkou späť:

• Vložiť alebo odstrániť bunku. Odstránené operácie môžete zrušiť výberom funkcie Zrušiť zmenu (textový obsah sa uchováva spolu s bunkou).
• Zmeňte poradie buniek.
• Prepnúť parameter.
• Konvertujte medzi bunkou kódu a bunkou jazyka Markdown.

Poznámka

Operácie s textom v bunke a operácie komentovania buniek kódu nie je možné vrátiť späť. Môžete vrátiť späť alebo zopakovať až 10 najnovších operácií historických buniek.

Presunutie bunky

Môžete presunúť myšou z prázdnej časti bunky a presunúť ju na požadované miesto.

Vybratú bunku môžete tiež premiestniť pomocou možností Posunúť nahor a Posunúť nadol na páse s nástrojmi.

Odstránenie bunky

Ak chcete bunku odstrániť, vyberte tlačidlo Odstrániť na pravej strane bunky.

Klávesové skratky môžete použiť aj v režime príkazov. Stlačte D,D (D dvakrát) na vymazanie aktuálnej bunky.

Zbalenie vstupu bunky

Ak chcete zbaliť vstup aktuálnej bunky, vyberte tri bodky (...) na paneli s nástrojmi bunky a položku Skryť vstup. Ak ju chcete znova rozbaliť, po zbalení bunky vyberte položku Zobraziť vstup .

Zbalenie výstupu bunky

Ak chcete zbaliť výstup aktuálnej bunky, vyberte tri bodky (...) na paneli s nástrojmi buniek a možnosti Skryť výstup. Ak ho chcete znova rozbaliť, vyberte položku Zobraziť výstup , keď je výstup bunky zbalený.

Zabezpečenie výstupu bunky

Roly prístupu k údajom OneLake (Preview) môžete použiť na konfiguráciu prístupu iba ku konkrétnym priečinkom v jazere počas dotazov poznámkového bloku. Používateľom bez prístupu k priečinku alebo tabuľke sa počas spúšťania dotazu zobrazí neoprávnená chyba.

Dôležité

Zabezpečenie sa vzťahuje iba počas vykonávania dotazu. Bunky poznámkového bloku, ktoré obsahujú výsledky dotazu, môžu zobraziť používatelia, ktorí nemajú oprávnenie priamo spúšťať dotazy na údaje.

Zamknutie alebo zmrazenie bunky

Operácie uzamknutia a zmrazenia vám umožňujú vytvárať bunky iba na čítanie alebo zastavenie spustenia buniek kódu jednotlivo.

Zlúčenie a rozdelenie buniek

Funkciu Zlúčenie s predchádzajúcou bunkou alebo Zlúčiť s ďalšou bunkou môžete použiť na pohodlné zlúčenie súvisiacich buniek.

Výberom položky Rozdeliť bunku môžete rozdeliť irelevantné príkazy do viacerých buniek. Operácia rozdelí kód podľa pozície riadka kurzora.

Obsah poznámkového bloku

Výberom možnosti Obrysy alebo Obsah sa pre rýchlu navigáciu zobrazí prvá hlavička jazyka Markdown ľubnej bunky v bočnom okne. Bočný panel Obrysy je možné zmeniť jeho veľkosť a zbaliteľný tak, aby sa obrazovka čo najlepšie zmestila. Vyberte tlačidlo Obsah na paneli príkazov poznámkového bloku, čím otvoríte alebo skryjete bočný panel.

Postupné posúvanie v jazyku Markdown

Možnosť skladania v jazyku Markdown umožňuje skryť bunky pod bunkou jazyka Markdown, ktorá obsahuje nadpis. Bunka jazyka Markdown a jej skryté bunky sa pri vykonávaní operácií buniek považujú za množinu súvislých buniek s viacnásobným výberom.

Nájsť a nahradiť

Možnosť vyhľadať a nahradiť vám pomôže nájsť zhodu a vyhľadať kľúčové slová alebo výraz v rámci obsahu poznámkového bloku. Cieľový reťazec môžete tiež jednoducho nahradiť novým reťazcom.

Dokončovanie vloženého kódu druhého pilota (ukážka)

Dokončenie vloženého kódu kopilot je funkcia s pohonom umelej inteligencie, ktorá vám pomôže písať kód v jazyku Python rýchlejšie a efektívnejšie v poznámkových blokoch služby Fabric. Táto funkcia poskytuje inteligentné kontextové návrhy kódu počas písania kódu. Minimalizuje opakované úlohy, minimalizuje syntaktické chyby a urýchľuje vývoj bezproblémovou integráciou do pracovného postupu poznámkového bloku.

Kľúčové výhody

• Dokončenia riadené umelou inteligenciou: Generuje návrhy na základe kontextu poznámkového bloku pomocou modelu trénovaného na milióny riadkov kódu.
• Zvyšuje produktivitu: Pomáha písať komplexné funkcie, znižuje opakovanie kódovania a urýchľuje skúmanie neznámych knižníc.
• Znižuje počet chýb: Minimalizuje preklepy a chyby syntaxe pomocou inteligentných kontextových dokončovaní.
• Minimálne nastavenie: Zabudovaný do notebookov Fabric a nevyžaduje žiadnu inštaláciu. Stačí ju zapnúť a začať s kódovaním.

Ako to funguje

Zapnite návrhy vloženého kódu pomocou prepínača v dolnej časti poznámkového bloku.

Počas zadávania sa návrhy zobrazia v svetlosivom texte. Stlačením klávesu Tab môžete prijať alebo upraviť návrhy. Návrhy vychádzajú z predchádzajúcich buniek poznámkového bloku.

Poznámka

Povolenie dokončovania kódu Copilot spotrebuje viac jednotiek kapacity.

Aktuálne obmedzenia

• Funkcia Copilot Inline Code Completion aktuálne podporuje jazyk Python a používa kontext z predchádzajúcich buniek a schém služby Lakehouse.
• Návrhy uvažujú o údajoch zo schém Lakehouse.
• Iba podmnožina prvkov schémy sa použije, ak existuje veľa tabuliek alebo stĺpcov.
• Dynamicky vytvorené tabuľky (cez Spark) nie sú rozpoznané v reálnom čase.

Spustenie poznámkových blokov

Bunky kódu môžete spustiť v notebooku jednotlivo alebo všetky naraz. Stav a priebeh každej bunky sa zobrazí v poznámkovom okne.

Spustenie bunky

Existuje niekoľko spôsobov, ako spustiť kód v bunke.

• Ukážte myšou na bunku, ktorú chcete spustiť, a vyberte tlačidlo Spustiť bunku alebo stlačte kombináciu klávesov Ctrl + Enter.

• V režime príkazov použite klávesovú skratku. Stlačením klávesov Shift + Enter spustite aktuálnu bunku a vyberte nasledujúcu bunku. Stlačením kombinácie klávesov Alt + Enter spustite aktuálnu bunku a vložte novú bunku.

Spustenie všetkých buniek

Ak chcete spustiť všetky bunky v aktuálnom poznámkovom bloku v poradí, vyberte tlačidlo Spustiť všetko.

Spustenie všetkých buniek nad alebo pod sebou

Rozbaľte rozbaľovací zoznam z okna Spustiť všetko a výberom položky Spustiť bunky vyššie spustite všetky bunky nad aktuálnou sekvenciou. Ak chcete spustiť aktuálnu bunku a všetky bunky pod aktuálnou v poradí, vyberte položku Spustiť bunky nižšie .

Zrušiť všetky spustené bunky

Ak chcete zrušiť spustené bunky alebo bunky čakajúce vo fronte, vyberte položku Zrušiť všetky .

Zastavenie relácie

Zastaviť reláciu zruší spustené a čakajúce bunky a zastaví aktuálnu reláciu. Úplne novú reláciu môžete reštartovať opätovným výberom možnosti spustenia.

Referenčné spustenie

Odkaz na spustenie poznámkového bloku

Okrem referenčného rozhrania API notebookutils môžete použiť %run <notebook name> aj magický príkaz na odkazovanie na iný notebook v kontexte aktuálneho poznámkového bloku. Všetky premenné definované v referenčnom poznámkovom bloke sú k dispozícii v aktuálnom poznámkovom bloku. Magický %run príkaz podporuje vnorené volania, ale nepodporuje rekurzívne volania. Ak je hĺbka príkazu väčšia ako päť, zobrazí sa výnimka.

Príklad: %run Notebook1 { "parameterInt": 1, "parameterFloat": 2.5, "parameterBool": true, "parameterString": "abc" }.

Odkaz na poznámkový blok funguje v interaktívnom režime aj v kanáli.

Poznámka

• Príkaz %run v súčasnosti podporuje len referenčné poznámkové bloky, ktoré sa nachádzajú v tom istom pracovnom priestore s aktuálnym poznámkovým blokom.
• Príkaz %run aktuálne podporuje iba 4 typy hodnôt parametrov: int, float, boola string. Operácia nahradenia premennej nie je podporovaná.
• Príkaz %run nepodporuje vnorené odkazy s hĺbkou väčšou ako päť.

Odkaz na spustenie skriptu

Príkaz %run tiež umožňuje spúšťať súbory jazyka Python alebo SQL, ktoré sú uložené vo vstavaných zdrojoch poznámkového bloku, takže súbory zdrojového kódu môžete vykonať v notebooku pohodlne.

%run [-b/--builtin -c/--current] [script_file.py/.sql] [variables ...]

Možnosti:

• -b/-builtin: Táto možnosť označuje, že príkaz vyhľadá a spustí zadaný súbor skriptu zo vstavaných prostriedkov poznámkového bloku.
• -c/-current: Táto možnosť zaisťuje, že príkaz vždy používa vstavané zdroje aktuálneho notebooku, dokonca aj vtedy, ak na aktuálny prenosný počítač odkazuje iné poznámkové bloky.

Príklady:

• Spustenie script_file.py zo vstavaných zdrojov:%run -b script_file.py

• Spustenie script_file.sql zo vstavaných zdrojov:%run -b script_file.sql

• Spustenie script_file.py zo vstavaných zdrojov s konkrétnymi premennými:%run -b script_file.py { "parameterInt": 1, "parameterFloat": 2.5, "parameterBool": true, "parameterString": "abc" }

Poznámka

Ak príkaz neobsahuje prvok -b/--builtin, pokúsi sa vyhľadať a spustiť poznámkový blok v rámci toho istého pracovného priestoru, a nie v vstavaných zdrojoch.

Príklad použitia pre vnorený prípad spustenia:

• Predpokladajme, že máme dva notebooky.
  • Notebook1: obsahuje script_file1.py vo svojich vstavaných zdrojoch
  • Notebook2: Obsahuje script_file2.py vo svojich vstavaných zdrojoch
• Poznámkový blok 1 použijeme
• V notebooku2 potom pokyny na používanie:
  • Ak chcete spustiť script_file1.py v Notebook1(koreňový poznámkový blok), ide o tento kód: %run -b script_file1.py
  • Ak chcete spustiť script_file2.py v Notebook2(aktuálny poznámkový blok), ide o tento kód: %run -b -c script_file2.py

Prieskumník premenných

Poznámkové bloky služby Fabric poskytujú vstavaného prieskumníka premenných, ktorý zobrazuje zoznam premenných s názvom, typom, dĺžkou a hodnotou v aktuálnej relácii služby Spark pre bunky v jazyku PySpark (Python). Ďalšie premenné sa automaticky zobrazia tak, ako sú definované v bunkách kódu. Kliknutím na jednotlivé hlavičky stĺpcov sa zoradia premenné v tabuľke.

Ak chcete otvoriť alebo skryť prieskumníka premenných, vyberte položku Premenné na poznámkovom bloke na páse s nástrojmi Zobrazenie.

Poznámka

Prieskumník premenných podporuje len jazyk Python.

Indikátor stavu bunky

Pod bunkou sa zobrazuje podrobný stav vykonávania buniek, ktorý vám pomôže zobraziť jej aktuálny priebeh. Po dokončení spustenia bunky sa zobrazí súhrn vykonávania s celkovým trvaním a časom ukončenia, ktorý je tam uložený na použitie v budúcnosti.

Indikátor stavu relácie

Konfigurácia časového limitu relácie

V ľavom dolnom rohu môžete vybrať stav relácie a získať ďalšie informácie o aktuálnej relácii:

V kontextovom okne je k dispozícii možnosť obnoviť časový limit na x minúty alebo hodiny.

Vyberte si, ako dlho chcete neprerušovanú reláciu, a stlačte tlačidlo Použiť. Časový limit relácie sa resetuje o novú hodnotu. To je tiež vhodné!

Môžete tiež nastaviť časový limit, ako je to popísané v téme:

• Nastavenia správy pracovného priestoru dátového inžiniera v službe Microsoft Fabric
• Príkaz konfigurácie relácie spark

Zostaňte prihlásení: Ak sa počas prihlasovania zobrazí dialógové okno Zostať prihlásený , výberom položky Áno deaktivujte časový limit nečinnej relácie pre aktuálnu reláciu.

Dôležité

Nezačiarknite políčko Nezobrazovať znova , pretože sa tým natrvalo uzamknú nastavenia prihlásenia. Táto možnosť sa nemusí zobraziť, ak správca nájomníka zakázal nastavenie Zostať prihlásený (KMSI).

Žiadosť o zmenu politiky: Ak potrebujete dlhšie trvanie relácie, požiadajte správcu nájomníka, aby predĺžil politiku trvania trvania nečinnej relácie. Môžu to urobiť tak, že prejdú na Nastavenia > organizácie Časový limit nečinnej relácie zabezpečenia a ochrany osobných údajov > v Centre spravovania služby Microsoft 365.

Poznámka

Výber KMSI a/alebo predĺženie časového limitu nečinnosti rozširuje riziko prístupu k odomknutému stroju.

Ako abt a nečinnosti relácie vplyv dlho-beh Fabric Notebook vykonáva?

Ak váš nájomník používa časový limit založený na aktivite (ABT), dlhotrvajúce interaktívne úlohy v poznámkových blokoch služby Fabric môžu byť ovplyvnené politikou časového limitu nečinnosti relácie služby Microsoft 365. Táto funkcia zabezpečenia je navrhnutá tak, aby odhlasovala používateľov v neaktívnych nespravovaných zariadeniach, a to aj v prípade, že úloha poznámkového bloku je stále spustená. Hoci aktivita v iných aplikáciách služby Microsoft 365 umožňuje udržať živé relácie, zariadenia v nečinnosti sa odhlásia podľa návrhu.

Prečo sú používatelia odhlásení aj vtedy, keď je úloha poznámkového počítača stále spustená?

Časový limit relácie nečinnosti uprednostňuje zabezpečenie ukončením relácií v neaktívnych zariadeniach, aby sa zabránilo neoprávnenému prístupu. Aj keď vykonáva poznámkový blok, relácia sa končí, ak zariadenie nepreznáša žiadnu aktivitu. Vedenie relácií otvorených v nečinných zariadeniach by ohrozilo zabezpečenie, a preto je aktuálne správanie vynútené.

Indikátor úlohy Inline Apache Spark

Látkové poznámkové bloky sú založené na Apache Sparku. Bunky kódu sa spúšťajú na diaľku v klastri Apache Spark. Indikátor priebehu úlohy Spark je k dispozícii s indikátorom priebehu v reálnom čase, ktorý vám pomôže pochopiť stav vykonávania úlohy. Počet úloh v každej úlohe alebo fáze vám pomôže identifikovať paralelnú úroveň vašej práce v službe Spark. Môžete tiež prejsť na podrobnosti používateľského rozhrania služby Spark konkrétnej úlohy (alebo fázy) výberom prepojenia na názov úlohy (alebo fázy).

Môžete tiež nájsť denník na úrovni bunky v reálnom čase vedľa indikátora pokroku a funkcia Diagnostika vám môže poskytnúť užitočné návrhy, ktoré vám pomôžu kód spresniť a doladiť.

V časti Ďalšie akcie môžete jednoducho prejsť na stránku s podrobnosťami aplikácie Spark a stránku webového používateľského rozhrania služby Spark.

Redigovanie tajných kódov

Aby sa zabránilo neúmyselne unikli poverenia pri spustení notebooky, Fabric notebooky podporu Secret redaction nahradiť tajné hodnoty, ktoré sa zobrazujú vo výstupe bunky s [REDACTED]. Redigovanie tajným kódom sa vzťahuje na jazyk Python, Scala a R.

Magické príkazy v notebooku

Vstavané magické príkazy

Môžete použiť známe magické príkazy Ipython v poznámkových blokoch služby Fabric. Pozrite si nasledujúci zoznam aktuálne dostupných magických príkazov.

Poznámka

Toto sú jediné magické príkazy podporované v kanáli služby Fabric: %%pyspark, %%spark, %%csharp, %%sql, %%configure.

Dostupné čiarové príkazy: %lsmagic, %time, %timeit, %history, %run, %load, %alias, %alias_magic, %autoawait, %autocall, %automagic, %bookmark, %cd, %colors, %dhist, %dirs, %doctest_mode, %killbgscripts, %load_ext, %logoff, %logon, %logstart, %logstate, %logstop, %magic, %matplotlib, %page, %pastebin, %pdef, %pfile, %pinfo, %pinfo2, %popd, %pprint, %precision, %prun, %psearch, %psource, %pushd, %pwd, %pycat, %quickref, % rehashx, %reload_ext, %reset, %reset_selective, %sx, %system, %tb, %unalias, %unload_ext, %who, %who_ls, %who's, %xdel, %xmode.

Poznámkový blok služby Fabric tiež podporuje vylepšené príkazy na správu knižnice %PIP a %conda. Ďalšie informácie o používaní nájdete v téme Spravovanie knižníc Apache Spark v službe Microsoft Fabric.

Dostupné príkazy bunkovej mágie: %%time, %%timeit, %%capture, %%writefile, %%sql, %%pyspark, %%spark, %%csharp, %%configure, %%html, %%bash, %%markdown, %%perl, %%script, %%sh.

Vlastné magické príkazy

Môžete tiež vytvoriť viac vlastných magických príkazov, ktoré budú spĺňať vaše konkrétne potreby. Príklad:

1. Vytvorte notebook s názvom MyLakehouseModule.

   

2. V inom notebooku, odkaz na "MyLakehouseModule" a jeho magické príkazy. Týmto procesom môžete pohodlne usporiadať svoj projekt pomocou poznámkových blokov, ktoré používajú rôzne jazyky.

   

Miniaplikácie IPython

IPython Widgets sú eventful Python objekty, ktoré majú reprezentáciu v prehliadači. Miniaplikácie IPython môžete použiť ako ovládacie prvky s minimálnym použitím kódu (napríklad jazdec alebo textové pole) v notebooku rovnako ako poznámkový blok Jupyter. V súčasnosti to funguje len v kontexte jazyka Python.

Používanie miniaplikácií IPython

1. Najskôr importujte modul ipywidgets a použite rámec Jupyter Widget.

   import ipywidgets as widgets
   

2. Na vykreslenie miniaplikácie použite funkciu zobrazenia najvyššej úrovne alebo zanechajte výraz typu miniaplikácie v poslednom riadku bunky kódu.

   slider = widgets.IntSlider()
   display(slider)
   

3. Spustite bunku. Miniaplikácia sa zobrazí vo výstupnej oblasti.

   slider = widgets.IntSlider()
   display(slider)
   

   

4. Pomocou viacerých volaní display() môžete vykresliť rovnakú inštanciu miniaplikácie viackrát. Zostávajú vzájomne synchronizované.

   slider = widgets.IntSlider()
   display(slider)
   display(slider)
   

   

5. Ak chcete vykresliť dve miniaplikácie nezávislé od seba, vytvorte dve inštancie miniaplikácie:

   slider1 = widgets.IntSlider()
   slider2 = widgets.IntSlider()
   display(slider1)
   display(slider2)
   

   

Podporované miniaplikácie

Typ miniaplikácií	Widgety
Číselné miniaplikácie	IntSlider, FloatSlider, FloatLogSlider, IntRangeSlider, FloatRangeSlider, IntProgress, FloatProgress, BoundedIntText, BoundedFloatText, IntText, FloatText
Booleovské miniaplikácie	Prepínač, Začiarkavacie políčko, Platné
Miniaplikácie výberu	Rozbaľovacia ponuka, RadioButtons, Select, SelectionSlider, SelectionRangeSlider, ToggleButtons, SelectMultiple
Miniaplikácie reťazcov	Text, Oblasť textu, Rozbaľovacie pole, Heslo, Označenie, HTML, Matematika HTML, Obrázok, Tlačidlo
Miniaplikácie prehrávania (animácie)	Výber dátumu, výber farby, ovládač
Miniaplikácie kontajnera alebo rozloženia	Krabica, HBox, VBox, GridBox, Akordeón, Karty, Skladané

Známe obmedzenia

• Nasledujúce miniaplikácie zatiaľ nie sú podporované. K dispozícii sú nasledujúce alternatívne riešenia:

  Funkčnosť	Alternatívne riešenie
  Výstupná miniaplikácia	Namiesto toho môžete napísať text do stdout pomocou funkcie print( ).
  widgets.jslink()	Funkciu widgets.link() môžete použiť na prepojenie dvoch podobných miniaplikácií.
  Miniaplikácia FileUpload	Zatiaľ nie je podporované.

• Globálna zobrazovaná funkcia služby Fabric nepodporuje zobrazovanie viacerých miniaplikácií v jednom volaní (napríklad display(a, b)). Toto správanie sa líši od funkcie zobrazenia IPython.

• Ak zatvoríte poznámkový blok obsahujúci miniaplikáciu IPython, nebudete ho môcť zobraziť ani pracovať s ňou, kým príslušnú bunku znova nevykonáte.

• Funkcia interakcie (ipywidgets.interact) nie je podporovaná.

Integrácia poznámkového bloku

Vytvorenie bunky parametrov

Ak chcete parametrizovať poznámkový blok, vyberte tri bodky (...) a prejdite na panel s nástrojmi ďalšie príkazy na paneli s nástrojmi bunky. Potom vyberte položku Prepnúť bunku parametra, čím bunku určíte ako bunku parametrov.

Bunka parametra je užitočná na integráciu poznámkového bloku v kanáli. Aktivita kanála vyhľadá bunku parametrov a s touto bunkou zaobchádza ako s predvolenými pre parametre odovzdané v čase spustenia. Nástroj na spustenie pridá novú bunku pod bunku parametrov so vstupnými parametrami, aby sa prepíšu predvolené hodnoty.

Priradenie hodnôt parametrov z kanála

Po vytvorení poznámkového bloku s parametrami ho môžete spustiť z kanála s aktivitami poznámkového bloku služby Fabric. Po pridaní aktivity na plátno kanála môžete nastaviť hodnoty parametrov v časti Základné parametre na karte Nastavenia .

Pri priraďovaní hodnôt parametrov môžete použiť jazyk výrazu kanála alebo funkcie a premenné.

Parametre poznámkového bloku podporujú jednoduché typy, ako napríklad int, float, , boola string. Zložité typy, ako napríklad list a dict zatiaľ nie sú podporované. Ak chcete odovzdať zložitý typ, zvážte jeho serializáciu do reťazcového formátu (napríklad JSON) a následnú deserializáciu v poznámkovom bloku. Nasledujúca ukážka ukazuje, ako odovzdať reťazec JSON z kanála do poznámkového bloku a deserializovať ho:

Nasledujúci kód jazyka Python ukazuje, ako deserializovať reťazec JSON do slovníka jazyka Python:

import json

# Deserialize the JSON string into a Python dictionary
params = json.loads(json_string)

# Access the individual parameters
param1 = params.get("param1")
param2 = params.get("param2")

Uistite sa, že názov parametra v bunke kódu parametra sa zhoduje s názvom parametra v kanáli.

Príkaz konfigurácie relácie spark

Reláciu služby Spark môžete prispôsobiť pomocou magického príkazu %%configure. Notebook služby Fabric podporuje prispôsobené virtuálne jadrá, pamäť ovládača a vykonávača, vlastnosti Apache Spark, pripojenie bodov, bazén a predvolený lakehouse notebooku. Môžu byť použité v interaktívnych aktivitách poznámkového bloku aj poznámkového bloku kanála. Odporúčame, aby ste na začiatku poznámkového bloku spustili príkaz %%configure alebo reštartovať reláciu služby Spark, aby sa nastavenia prejavili.

%%configure
{
    // You can get a list of valid parameters to config the session from https://github.com/cloudera/livy#request-body.
    "driverMemory": "28g", // Recommended values: ["28g", "56g", "112g", "224g", "400g"]
    "driverCores": 4, // Recommended values: [4, 8, 16, 32, 64]
    "executorMemory": "28g",
    "executorCores": 4,
    "jars": ["abfs[s]: //<file_system>@<account_name>.dfs.core.windows.net/<path>/myjar.jar", "wasb[s]: //<containername>@<accountname>.blob.core.windows.net/<path>/myjar1.jar"],
    "conf":
    {
        // Example of customized property, you can specify count of lines that Spark SQL returns by configuring "livy.rsc.sql.num-rows".
        "livy.rsc.sql.num-rows": "3000",
        "spark.log.level": "ALL"
    },
    "defaultLakehouse": {  // This overwrites the default lakehouse for current session
        "name": "<lakehouse-name>",
        "id": "<(optional) lakehouse-id>",
        "workspaceId": "<(optional) workspace-id-that-contains-the-lakehouse>" // Add workspace ID if it's from another workspace
    },
    "mountPoints": [
        {
            "mountPoint": "/myMountPoint",
            "source": "abfs[s]://<file_system>@<account_name>.dfs.core.windows.net/<path>"
        },
        {
            "mountPoint": "/myMountPoint1",
            "source": "abfs[s]://<file_system>@<account_name>.dfs.core.windows.net/<path1>"
        },
    ],
    "environment": {
        "id": "<environment-id>",
        "name": "<environment-name>"
    },
    "sessionTimeoutInSeconds": 1200,
    "useStarterPool": false,  // Set to true to force using starter pool
    "useWorkspacePool": "<workspace-pool-name>"
}

Poznámka

• Odporúča sa nastaviť rovnakú hodnotu pre DriverMemory a ExecutorMemory v %%configure. Hodnoty driverCores a executorCores by tiež mali byť rovnaké.
• "DefaultLakehouse" prepíše váš pripnutý lakehouse v Lakehouse explorer, ale to funguje len vo vašom aktuálnom notebooku zasadnutí.
• V kanáloch služby Fabric môžete použiť %%configure, ale ak nie je nastavená v prvej bunke kódu, spustenie kanála zlyhá z dôvodu možnosti reštartovania relácie.
• %%configure použitý v notebookutils.notebook.run sa ignoruje, ale používa sa v %run poznámkovom bloku, ktorý sa naďalej vykonáva.
• Štandardné vlastnosti konfigurácie služby Spark je nutné použiť v tele conf. Fabric nepodporuje odkazy na prvú úroveň pre vlastnosti konfigurácie služby Spark.
• Niektoré špeciálne vlastnosti Spark, vrátane "spark.driver.cores", "spark.executor.cores", "spark.driver.memory", "spark.executor.memory" a "spark.executor.instances" nemajú vplyv v tele "conf".

Pomocou magického %%configure príkazu môžete do poznámkového bloku dynamicky vložiť hodnoty konfigurácie z knižnice premenných .

%%configure
{
  "defaultLakehouse": {
    "name": {
      "variableName": "$(/**/myVL/LHname)" 
    },
    "id": {
      "variableName": "$(/**/myVL/LHid)"
    },
    "workspaceId": {
      "variableName": "$(/**/myVL/WorkspaceId)"
    }
  }
}

V tomto príklade:

• myVL je názov vašej knižnice premenných.
• LHname, LHid, a WorkspaceId sú premenné kľúče definované v knižnici.
• Všetky premenné by mali byť definované ako typ reťazca v knižnici premenných, dokonca aj pre hodnoty GUID.
• Je to workspaceId potrebné, keď je jazerný dom v inom pracovnom priestore ako aktuálny zápisník.
• Tieto hodnoty sa riešia za behu v závislosti od aktívneho prostredia (napríklad Dev, Test, Prod).

Vďaka tomu môžete prepnúť konfigurácie ako predvolený lakehouse bez toho, aby ste museli upravovať kód poznámkového bloku.

Parametrizovaná konfigurácia relácie z kanála

Konfigurácia parametrizovanej relácie umožňuje nahradiť hodnotu v %%configure magic parametrami aktivity poznámkového bloku spustenia kanála. Pri príprave bunky kódu v %%configure môžete prepísať predvolené hodnoty (v nižšie uvedenom príklade tiež konfigurovateľné, 4 a "2000") týmto objektom:

{
      "parameterName": "paramterNameInPipelineNotebookActivity",
      "defaultValue": "defaultValueIfNoParamterFromPipelineNotebookActivity"
} 

%%configure  

{ 
    "driverCores": 
    { 
        "parameterName": "driverCoresFromNotebookActivity", 
        "defaultValue": 4 
    }, 
    "conf": 
    { 
        "livy.rsc.sql.num-rows": 
        { 
            "parameterName": "rows", 
            "defaultValue": "2000" 
        } 
    } 
} 

Poznámkový blok používa predvolenú hodnotu, ak poznámkový blok spustíte priamo v interaktívnom režime, alebo ak aktivita poznámkového bloku kanála neposkytuje žiadny parameter, ktorý by zodpovedá názvu activityParameterName.

Počas spustenia kanála môžete nakonfigurovať nastavenia aktivity notebooku kanála takto:

Ak chcete zmeniť konfiguráciu relácie, názov parametrov aktivity poznámkového kanála by mal byť rovnaký ako parameterName v poznámkovom bloku. V tomto príklade spustenia kanála driverCores sa hodnota v %%configure nahradí číslom 8 a livy.rsc.sql.num-rows nahradí sa číslom 4 000.

Poznámka

• Ak spustenie kanála zlyhá, pretože ste použili príkaz %%configure magic, nájdite ďalšie informácie o chybe spustením magickej bunky v interaktívnom režime poznámkového bloku.
• Plánované poznámkové bloky nepodporia parametrizovanú konfiguráciu relácie.

Zapisovanie jazyka Python do denníka v poznámkovom bloke

Denníky jazyka Python môžete nájsť a nastaviť rôzne úrovne denníkov a formát, ako napríklad vzorový kód uvedený tu:

import logging

# Customize the logging format for all loggers
FORMAT = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
formatter = logging.Formatter(fmt=FORMAT)
for handler in logging.getLogger().handlers:
    handler.setFormatter(formatter)

# Customize log level for all loggers
logging.getLogger().setLevel(logging.INFO)

# Customize the log level for a specific logger
customizedLogger = logging.getLogger('customized')
customizedLogger.setLevel(logging.WARNING)

# logger that use the default global log level
defaultLogger = logging.getLogger('default')
defaultLogger.debug("default debug message")
defaultLogger.info("default info message")
defaultLogger.warning("default warning message")
defaultLogger.error("default error message")
defaultLogger.critical("default critical message")

# logger that use the customized log level
customizedLogger.debug("customized debug message")
customizedLogger.info("customized info message")
customizedLogger.warning("customized warning message")
customizedLogger.error("customized error message")
customizedLogger.critical("customized critical message")

Zobrazenie histórie vstupných príkazov

Fabric notebook podporu magický príkaz %history vytlačiť históriu vstupných príkazov, ktoré sa vykonali v súčasnej relácii, v porovnaní so štandardným Príkazom Jupyter Ipython %history práce pre viacero jazykov kontexte v notebooku.

%history [-n] [range [range ...]]

Možnosti:

• -n: Tlač čísla vykonania.

Kde môže byť rozsah:

• N: Vytlačte kód N-tej vykonanej bunky.
• M-N: Tlač kódu z Mth do nth spustenej bunky.

Príklad:

• Tlač histórie vstupov z 1. do 2. spustenej bunky: %history -n 1-2

Klávesové skratky

Podobne ako notebooky Jupyter, aj notebooky služby Fabric majú modálne používateľské rozhranie. Klávesnica vykonáva rôzne činnosti v závislosti od režimu, v ktorom sa nachádza bunka poznámkového bloku. Poznámkové bloky služby Fabric podporujú nasledujúce dva režimy pre danú bunku kódu: režim príkazu a režim Úprav.

• Bunka sa nachádza v režime príkazu, keď sa nezobrazuje žiadny textový kurzor s výzvou na zadanie. Keď je bunka v režime príkazov, môžete upraviť poznámkový blok ako celok, ale nemôžete ho písať do jednotlivých buniek. Stlačením klávesu ESC alebo myšou otvorte režim príkazov a vyberte mimo oblasti editora bunky.

  

• Režim úprav možno indikovať z textového kurzora s výzvou na zadanie textu do oblasti editora. Keď je bunka v režime úprav, môžete do bunky zadať text. Stlačením klávesu Enter alebo myšou otvorte režim úprav a vyberte oblasť editora bunky.

  

Klávesové skratky v režime príkazov

Akcia	Odkazy na poznámkové bloky
Spustite aktuálnu bunku a vyberte ju nižšie.	Shift + Enter
Spustenie aktuálnej bunky a vloženie pod	Alt + Enter
Spustenie aktuálnej bunky	CTRL + Enter
Vyberte bunku nad	Nahor
Vyberte bunku nižšie	Nadol
Vyberte predchádzajúcu bunku	K
Vyberte ďalšiu bunku	J
Vložiť bunku nad	A
Vložiť bunku pod	B
Odstránenie vybratých buniek	D,D
Prepnúť na režim úprav	Vstúpiť

Klávesové skratky v režime úprav

Pomocou nasledujúcich klávesových skratiek môžete v režime úprav jednoducho navigovať a spustiť kód v poznámkových blokoch služby Fabric.

Akcia	Odkazy na poznámkové bloky
Presunúť kurzor nahor	Nahor
Presunúť kurzor nadol	Nadol
Zrušiť zmenu	Ctrl + Z
Znova	Ctrl + Y
Komentár alebo Uncomment	Ctrl + / Komentár: Ctrl + K + C Zrušiť komentár: Ctrl + K + U
Odstránenie slova predtým	Ctrl + Backspace
Odstránenie slova potom	Ctrl + Odstrániť
Prejsť na začiatok bunky	Ctrl + Domov
Prejsť na koniec bunky	Ctrl + Koniec
Zostáva jedno slovo	Ctrl + doľava
Skúste na to jedno slovo	CTRL + doprava
Vybrať všetko	Ctrl + A
Odsadiť	Ctrl + ]
Dedent	Ctrl + [
Prepnutie do režimu príkazov	Esc

Ak chcete vyhľadať všetky klávesové skratky, vyberte položku Zobraziť na páse s nástrojmi poznámkového bloku a potom vyberte položku Klávesové skratky.

Súvisiaci obsah

• Vizualizácia poznámkového blokov
• Úvod do notebookov pre fabric