Ako používať poznámkové bloky služby Microsoft Fabric

Notebook služby Microsoft Fabric je primárnou položkou kódu na vývoj úloh v službe Apache Spark a experimentov v strojovom učení. 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. Dátoví inžinieri píšu kód na príjem údajov, prípravu údajov a transformáciu údajov. Dátoví vedci tiež používajú poznámkové bloky na vytváranie riešení strojového učenia vrátane vytvárania experimentov a modelov, sledovania modelov a nasadenia.

Pomocou poznámkového bloku služby Fabric môžete:

  • Začnite pracovať s nulovým úsilím o nastavenie.
  • Jednoducho skúmajte a spracovávajte údaje s intuitívnym prostredím s minimálnym použitím kódu.
  • Uchovávajte údaje v bezpečí pomocou vstavaných podnikových funkcií zabezpečenia.
  • Analyzujte údaje v nespracovaných formátoch (CSV, txt, JSON atď.), formáty spracovaných súborov (parket, Delta Lake atď.) pomocou výkonných funkcií Spark.
  • Buďte produktívni vďaka vylepšeným možnostiam vytváranie a vstavanej vizualizácii údajov.

Tento článok popisuje, ako používať poznámkové bloky v prostredí dátovej vedy a dátového inžiniera.

Kontext zabezpečenia spusteného poznámkového bloku

Spustenie notebooku sa môže v službe Fabric spúšťať tromi rôznymi spôsobmi s úplnou flexibilitou pri splnení rôznych scenárov:

  • Interaktívne spustenie: Používateľ manuálne spustí vykonanie prostredníctvom rôznych položiek používateľského rozhrania alebo volania rozhrania REST API. Spustenie sa spustí v kontexte zabezpečenia aktuálneho používateľa.
  • Spustenie ako aktivita kanála: Spustenie sa spustí z kanála služby Fabric Data Factory. Podrobné kroky nájdete v téme Aktivita poznámkového bloku. Spustenie sa spustí v kontexte zabezpečenia vlastníka kanála.
  • Plánovač: Spustenie sa spustí z plánu plánovača. Spustenie bude spustené v kontexte zabezpečenia používateľa, ktorý nastavuje/aktualizuje plán plánovača.

Flexibilita týchto možností spúšťania s rôznymi kontextmi zabezpečenia umožňuje spĺňať rôzne scenáre a požiadavky, ale tiež vyžaduje, aby ste si boli vedomí kontextu zabezpečenia pri navrhovaní a vývoji poznámkového bloku, v opačnom prípade to môže spôsobiť neočakávané správanie a dokonca aj niektoré problémy so zabezpečením.

Pri prvom vytvorení poznámkového bloku sa zobrazí upozornenie, ktoré vám pripomenie riziko spustenia kódu bez jeho kontroly.

Snímka obrazovky zobrazujúca upozornenie na spustenie poznámkového bloku.

Tu je niekoľko najvhodnejších postupov, ktoré vám pomôžu vyhnúť sa problémom so zabezpečením:

  • Skôr než manuálne spustíte poznámkový blok, otvorte poznámkový blok a skontrolujte časť Podrobnosti v paneli Informácie o aktualizácii úpravy, uistite sa, že ste OK s najnovšou zmenou.
  • Skôr než do kanála pridáte aktivitu poznámkového bloku, otvorte poznámkový blok a v časti Podrobnosti na paneli Informácie sa uistite, že aktualizácia úpravy je v poriadku s najaktuálnejšou zmenou. Ak si nie ste istí najnovšou zmenou, radšej otvorte Poznámkový blok, aby ste mohli skontrolovať zmenu ešte predtým, ako ju pridáte do kanála.
  • Skôr než plán plánovača aktualizujete, otvorte poznámkový blok a skontrolujte časť Podrobnosti v paneli Informácie o aktualizácii úpravy, aby ste sa uistili, že s najaktuálnejšou zmenou ste v poriadku. Ak si nie ste istí najnovšou zmenou, skôr než aktualizujete plán plánovača, otvorte poznámkový blok, aby ste mohli skontrolovať zmenu.
  • Oddeľte pracovný priestor do inej fázy (vývojár, testovanie, prod) a kontrolujte prístup rôznych fáz, aby ste sa vyhli problému so zabezpečením. Do fázy prod pridajte iba používateľa, ktorému dôverujete.

Vytváranie poznámkových blokov

Môžete buď vytvoriť nový poznámkový blok, alebo importovať existujúci poznámkový blok.

Vytvorenie nového poznámkového bloku

Podobne ako pri iných štandardných procesoch vytvárania položiek služby Fabric môžete jednoducho vytvoriť nový poznámkový blok z domovskej stránky služby Fabric Dátový inžinier, pracovného priestoru Nová možnosť alebo služby Vytvoriť centrum.

Import existujúcich poznámkových blokov

Pomocou položky na paneli s nástrojmi pracovného priestoru môžete importovať jeden alebo viac existujúcich poznámkových blokov z lokálneho počítača. Poznámkové bloky služby Fabric rozpoznávajú štandardný notebook Jupyter súbory .ipynb a zdrojové súbory, ako .py, .scalaa .sql, a zodpovedajúcim spôsobom vytvárajú nové poznámkové bloky.

Snímka obrazovky znázorňujúca miesto, kde možno nájsť možnosti poznámkového bloku v ponuke Nový.

Export poznámkového bloku

Poznámkový blok môžete exportovať do iných štandardných formátov. Notebook Synapse je možné exportovať do:

  • Štandardný notebook súbor (.ipynb), ktorý sa používa pre notebooky Jupyter.
  • Súbor HTML (.html), ktorý je možné otvoriť priamo z prehliadača.
  • Súbor v jazyku Python (.py).
  • Súbor Latex (.tex).

Snímka obrazovky znázorňujúca miesto exportu poznámkového bloku.

Uloženie poznámkového bloku

V službe Fabric sa poznámkový blok predvolene automaticky uloží po otvorení a úprave. Nemusíte sa starať o stratu zmien kódu. Môžete tiež použiť možnosť Uložiť kópiu na klonovanie inej kópie v aktuálnom pracovnom priestore alebo do iného pracovného priestoru.

Snímka obrazovky zobrazujúca miesto uloženia kópie.

Ak chcete prenosný počítač uložiť manuálne, môžete prepnúť na možnosť Manuálne uloženie, aby ste mali lokálnu vetvu poznámkového bloku. Zmeny potom uložíte pomocou kombinácie klávesov Save alebo CTRL + s .

Snímka obrazovky znázorňujúca miesto, kde prepnúť manuálne uloženie.

Výberom položky Upraviť -Uložiť možnosti -> Ak chcete zapnúť lokálnu vetvu poznámkového bloku a potom ju uložiť manuálne, vyberte možnosť Uložiť alebo použite klávesovú skratku Ctrl + s .

Pripojenie domov lakehouse a notebookov

Poznámkové bloky tkaniny teraz podporujú úzke interakcie s jazerami; môžete ľahko pridať nový alebo existujúci lakehouse od prieskumníka Lakehouse.

Môžete prejsť do rôznych lakehouses v Lakehouse explorer a nastaviť jeden lakehouse ako predvolený pripnutím. Predvolená hodnota sa potom pripevní k pracovnému adresáru runtime a pomocou lokálnej cesty môžete čítať predvolený domov lakehouse alebo ho zapisovať.

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

Poznámka

Reláciu musíte reštartovať po pripnutí nového jazera alebo premenovaní predvoleného jazera.

Pridať alebo odstrániť lakehouse

Výberom ikony X vedľa názvu jazera sa tento názov odstráni z karty poznámkového bloku, ale položka lakehouse v pracovnom priestore stále existuje.

Vyberte položku Pridať lakehouse a pridajte ďalšie jazerá do notebooku, a to buď pridaním existujúceho alebo vytvorením nového jazera.

Preskúmanie súboru lakehouse

Podpriečinok a súbory v časti Tabuľky a súbory zobrazenia Jazera sa zobrazia v oblasti obsahu medzi zoznamom lakehouse a obsahom poznámkového bloku. V časti Tabuľky a súbory vyberte rôzne priečinky a obnovte oblasť obsahu.

Operácie priečinkov a súborov

Ak vyberiete súbor (.csv, .parquet, .txt, .jpg, .png atď.) pravým tlačidlom myši, na načítanie údajov môžete použiť rozhranie API Spark alebo Pandas. Vygeneruje sa nová bunka kódu a vloží sa pod bunku zamerania.

Cestu môžete jednoducho skopírovať s iným formátom z vybraného súboru alebo priečinka a použiť zodpovedajúcu cestu v kóde.

Snímka obrazovky znázorňujúca kontextová ponuka súborov v službe Lakehouse.

Zdroje poznámkového bloka

Prieskumník prostriedkov notebooku poskytuje systém súborov typu Unix, ktorý vám pomôže spravovať priečinky a súbory. Ponúka zapisovateľný priestor systému súborov, v ktorom môžete ukladať súbory s malou veľkosťou, ako sú napríklad moduly kódu, sémantické modely a obrázky. Môžete k nim jednoducho pristupovať pomocou kódu v notebooku, akoby ste pracovali s lokálnym systémom súborov.

animovaný GIF poznámkových prostriedkov.

Poznámka

  • Maximálne úložisko prostriedkov pre vstavaný priečinok aj priečinok prostredia je 500 MB s veľkosťou jedného súboru až do 100 MB. Oba umožňujú spolu až 100 inštancií súborov/priečinkov.
  • Pri použití notebookutils.notebook.run()príkazu použite notebookutils.nbResPath príkaz na prístup k cieľovým poznámkovým blokom. Relatívna cesta vstavaná/ bude vždy odkazovať na vstavaný priečinok koreňového poznámkového bloku.

Priečinok vstavaných zdrojov

Vstavaný priečinok prostriedkov je systémovo preddefinovaný priečinok pre každú inštanciu poznámkovej položky. Toto sú kľúčové možnosti pre zdroje poznámkového bloku.

  • Môžete použiť bežné operácie, ako je vytvorenie, odstránenie, nahrávanie, sťahovanie, presunutie, premenovanie, duplikovanie a vyhľadávanie v používateľskom rozhraní.
  • Môžete použiť relatívne cesty, napríklad builtin/YourData.txt na rýchle preskúmanie. Metóda notebookutils.nbResPath vám pomôže vytvoriť úplnú cestu.
  • Overené údaje môžete jednoducho premiestniť do jazera pomocou možnosti Zapisovať do jazera . Fabric vloží bohaté úryvky kódu pre bežné typy súborov, ktoré vám pomôžu rýchlo začať.
  • Tieto prostriedky sú k dispozícii aj v prípade spustenia poznámkového bloku odkazu prostredníctvom .notebookutils.notebook.run()

Priečinok prostriedkov prostredia

Priečinok Zdroje prostredia je zdieľaný odkladací priestor navrhnutý na zjednodušenie spolupráce vo viacerých poznámkových blokoch.

  • Kartu Zdroje nájdete v prostredí a úplnú operáciu na spravovanie súborov prostriedkov nájdete tu. Po pripojení poznámkového bloku k aktuálnemu prostrediu je možné tieto súbory zdieľať medzi viacerými poznámkovými blokmi.

    Snímka obrazovky znázorňujúca miesto spravovania prostriedkov v prostredí.

  • Na stránke Poznámkový blok v časti Zdroje zdedené z pripojeného prostredia jednoducho nájdete druhý koreňový priečinok.

    Snímka obrazovky znázorňujúca miesto, kde sa má otvoriť priečinok prostriedkov prostredia.

  • So vstavanými zdrojmi môžete tiež pracovať rovnako v súboroch alebo priečinkoch.

  • Cesta k zdroju prostredia sa automaticky pripevní na klaster poznámkového bloku. K zdrojom prostredia môžete získať prístup pomocou relatívnej cesty /env.

Editor súborov

Editor súborov umožňuje zobrazovať a upravovať súbory priamo v priečinku prostriedkov poznámkového bloku a v priečinku prostriedkov prostredia v notebooku. Typy podporovaných súborov zahŕňajú CSV, TXT, HTML, YML, PY, SQL a ďalšie. S editorom súborov môžete jednoducho pristupovať a upravovať súbory v notebooku, podporuje zvýraznenie kľúčových slov a poskytuje potrebnú jazykovú službu pri otváraní a úprave súborov s kódom, ako .py a .sql.

  • Prístup k tejto funkcii môžete získať prostredníctvom možnosti Zobraziť a upraviť v ponuke súboru. Dvakrát kliknite na súbor rýchlejšie.

    Snímka obrazovky znázorňujúca miesto na zobrazenie a úpravu súborov.

  • Zmeny obsahu v editore súborov je potrebné uložiť manuálne kliknutím na tlačidlo uložiť uložiť alebo klávesovú skratku: Ctrl + S, editor súborov nepodporuje automatické ukladanie.

  • Editor súborov je tiež ovplyvnený režimom poznámkového bloku. Súbory môžete zobraziť, ale nemôžete ich upravovať, ak sa nachádzate v režime poznámkového bloku bez povolenia na úpravu.

Poznámka

Tu je niekoľko obmedzení editora súborov.

  • Limit veľkosti súboru je 1 MB.
  • Zobrazenie a úprava týchto typov súborov nie je podporovaná: .xlsx a .parquet.

Spolupráca v poznámkovom bloke

Poznámkový blok služby Fabric je položka na spoluprácu, ktorá podporuje viacero používateľov, ktorí upravujú rovnaký poznámkový blok.

Po otvorení poznámkového bloku predvolene prejdete do režimu spolu úpravy a každá úprava poznámkového bloku sa automaticky uloží. Ak vaši kolegovia otvoria ten istý notebook v rovnakom čase, zobrazí sa ich profil, spustenie výstupu, indikátor kurzora, indikátor výberu a úprava sledovania. Pomocou funkcií spolupráce môžete jednoducho uskutočniť programovanie párov, vzdialené ladenie a doučovanie scenárov.

Snímka obrazovky znázorňujúca bunku kódu s inou úpravou používateľa.

Zdieľanie poznámkového bloku

Zdieľanie poznámkového bloku je pohodlný spôsob, ako môžete spolupracovať s členmi tímu. Oprávnené roly pracovného priestoru môžu predvolene zobrazovať alebo upravovať a spúšťať poznámkové bloky. Poznámkový blok môžete zdieľať so zadanými udelenými povoleniami.

  1. Na paneli s nástrojmi poznámkového bloku vyberte položku Zdieľať .

    Snímka obrazovky zobrazujúca miesto, kde vybrať položku Zdieľať.

  2. Vyberte príslušnú kategóriu osôb, ktoré môžu zobraziť tento poznámkový blok. Môžete vybrať možnosť Zdieľať, Upraviť alebo Spustiť povolenia pre príjemcov.

    Snímka obrazovky zobrazujúca miesto, kde vybrať povolenia.

  3. Po výbere možnosti Použiť môžete poznámkový blok odoslať priamo alebo skopírovať prepojenie na iných používateľov. Príjemcovia potom môžu otvoriť poznámkový blok so zodpovedajúcim zobrazením udeleným na základe úrovne povolení.

    Snímka obrazovky znázorňujúca miesto vytvorenia a odoslania prepojenia.

  4. Ak chcete ďalej spravovať povolenia poznámkového bloku, vyberte položku Zoznam>položiek pracovného priestoru Ďalšie možnosti a potom vyberte položku Spravovať povolenia. Na tejto obrazovke môžete aktualizovať existujúci prístup a povolenia pre poznámkový blok.

    Snímka obrazovky znázorňujúca miesto spravovania povolení v pracovnom priestore.

Komentovať bunku kódu

Komentovanie je ďalšou užitočnou funkciou pre scenáre spolupráce. V súčasnosti služba Fabric podporuje pridávanie komentárov na úrovni bunky.

  1. Výberom tlačidla Komentáre na paneli s nástrojmi poznámkového bloku alebo indikátore komentárov v bunke otvorte tablu Komentáre.

    Snímka obrazovky zobrazujúca miesto, kde vybrať položku Komentár.

  2. V bunke kódu vyberte kód, na table Komentáre vyberte položku Nové, pridajte komentáre a potom uložte položku Uverejniť komentár.

    Snímka obrazovky zobrazujúca miesto, kde vybrať položku Nové.

  3. Ak ich potrebujete, vyhľadajte možnosti Upraviť komentár, Vyriešiť vlákno a Odstrániť vlákno tak, že vedľa komentára vyberiete možnosť Viac.

Označovanie ostatných v komentári

"Označovanie" sa vzťahuje na zmieňovanie a informovanie používateľa vo vlákne komentárov, čím sa efektívne zlepšuje spolupráca na konkrétnych podrobnostiach.

  1. Vyberte časť kódu v bunke a novú postupnosť komentárov.

  2. Zadajte meno používateľa a vyberte ten správny v zozname návrhov, ak chcete spomenúť niekoho, kto by sa mal zmieniť o určitej časti.

  3. Zdieľajte svoje prehľady a uverejnite ich.

  4. Spustí sa e-mailové oznámenie a používateľ klikne na prepojenie Otvoriť komentáre prepojenie a rýchlo nájde túto bunku.

  5. Okrem toho oprávnite a nakonfigurujte povolenia pre používateľov pri označovaní osoby, ktorá nemá prístup, čím zaistíte, že vaše položky kódu budú správne spravované.

animovaný GIF označovania ostatných v komentári.

Poznámka

Pri položke komentára už označený používateľ nebude dostávať e-mailové oznámenie, ak do jednej hodiny aktualizujete komentár. Novému označenému používateľovi sa však odošle E-mailové oznámenie.

História verzií

Poznámka

V súčasnosti je funkcia vo verzii Preview.

História verzií umožňuje jednoducho vytvárať verzie zmien v živom poznámkovom bloke. Podporuje sledovanie histórie a správu notebookov s robustnými funkciami riadenia vstavaných verzií, čo je obzvlášť užitočné na spoluprácu s viacerými prispievateľmi v tom istom notebooku.

  1. Prístup k verzii histórie z globálneho panela s nástrojmi poznámkového bloku.

    Snímka obrazovky zobrazujúca prístup k histórii.

  2. Poznámkový blok podporuje dva spôsoby vytvorenia kontrolných bodov.

    • Manuálny kontrolný bod: Môžete manuálne vytvoriť novú verziu na zaznamenávanie míľnikov vývoja, čím získate flexibilitu pri spravovaní verzií poznámkového bloku.

      Snímka obrazovky zobrazujúca postup vytvorenia novej verzie.

    • Kontrolný bod systému: Tieto kontrolné body sa automaticky vytvoria každých 5 minút na základe časového intervalu úpravy notebookovým systémom, čím sa zabezpečí, že vaša práca bude konzistentne uložená a vytvorená. Záznamy o úprave nájdete zo všetkých prispievateľov v zozname časovej osi kontrolného bodu systému. Snímka obrazovky znázorňujúca rozbalenie zoznamu kontrolných bodov.

  3. Môžete kliknúť na kontrolný bod a otvoriť zobrazenie dif, zvýrazní rozdiely v obsahu medzi vybraným kontrolným bodom a aktuálnou dynamickou verziou vrátane rozdielov v obsahu bunky, výstupe bunky a metaúdajov. Verziu tohto kontrolného bodu možno spravovať jednotlivo v ponuke "viac možností".

    Snímka obrazovky zobrazujúca rozdiel v zobrazení.

  4. Ak chcete zachovať zápornú verziu, kliknite obnovíte z kontrolného bodu, prepíšete aktuálny poznámkový blok alebo použijete uložiť ako kópiu naklonovať do nového poznámkového bodu.

    Snímka obrazovky zobrazujúca ďalšie možnosti s kontrolným bodom.

Poznámka

  • Známe obmedzenie: Po kliknutí na tlačidlo Obnoviť a prechode späť na poznámkový bloksa prenosný počítač okamžite neobnoví z kontrolného bodu. Na paneli správ sa zobrazí výzva na zobrazenie zmien. Musíte kliknúť na tlačidlo Zobraziť zmeny a vybrať, aby ste uloženú verziu dokončili. Snímka obrazovky zobrazujúca zobrazenie zmien po obnovení.
  • Platnosť systémových kontrolných bodov uplynie po 1 roku.

Prepínač režimu poznámkového blokov

Poznámkové bloky služby Fabric podporujú štyri režimy, ktoré možno jednoducho prepínať: vyvinúť režim,režim iba na, režim Upraviť a režim Zobraziť. Každý režim sa primapuje ku konkrétnej kombinácii povolení. Pri zdieľaní poznámkového bloku s ostatnými členmi tímu môžete príjemcom udeliť správne povolenia. Najlepší dostupný režim poznámkového bloku môžu vidieť podľa svojho povolenia a môžu prepínať medzi režimami, ku ktorým majú povolenie.

Snímka obrazovky znázorňujúca miesto prepínania režimov.

  • Režim vývoja: na čítanie, spúšťanie a zapisovanie je potrebné povolenie.
  • Režim Iba spustiť: potrebné povolenie na čítanie, vykonanie.
  • Režim úprav: je potrebné povolenie na čítanie, zapisovaie.
  • Režim zobrazenia: potrebné povolenie na čítanie.