Jak používat poznámkové bloky Microsoft Fabric

Poznámkový blok Microsoft Fabric je primární položkou kódu pro vývoj úloh Apache Sparku a experimentů strojového učení. Jedná se o webovou interaktivní surface, kterou používají datoví vědci a datoví inženýři k psaní kódu, který přináší výhody bohatých vizualizací a textu Markdownu. Datoví inženýři zapisuje kód pro příjem dat, přípravu dat a transformaci dat. Datoví vědci také používají poznámkové bloky k vytváření machine learning řešení, včetně vytváření experimentů a modelů, sledování modelů a nasazení.

S poznámkovým blokem Fabric můžete:

• Začněte bez nutnosti jakéhokoli nastavování.
• Snadné zkoumání a zpracování dat pomocí intuitivního prostředí s nízkým kódem
• Udržujte data zabezpečená pomocí integrovaných podnikových funkcí zabezpečení.
• Analýza dat v nezpracovaných formátech (CSV, txt, JSON atd.), zpracovaných formátech souborů (parquet, Delta Lake atd.) s využitím výkonných funkcí Sparku
• Buďte produktivní díky vylepšeným možnostem vytváření a integrované vizualizaci dat.
• Využijte Copilot pro kontextově uvědomělé generování, refaktoring a ověřování kódu v celém poznámkovém bloku.
• Rychle diagnostikujte a opravujte neúspěšné buňky nebo úlohy Sparku pomocí nástroje Fix s použitím Copilot, který umožňuje změny kódu vyžadující schválení.

Tento článek popisuje, jak používat poznámkové bloky v prostředích datových věd a přípravy dat.

Kontext zabezpečení spuštěného poznámkového bloku

Spouštění poznámkových bloků se dá aktivovat třemi způsoby, z nichž každý má jiný kontext zabezpečení:

• Interaktivní spuštění: Spuštění spustíte ručně prostřednictvím uživatelského rozhraní nebo rozhraní REST API. Notebook pracuje v rámci vašeho zabezpečení (aktuální uživatel).
• Spuštění jako aktivita pipeline: Spuštění se aktivuje z pipeline služby Fabric Data Factory. Podrobnosti najdete v aktivitě poznámkového bloku . Poznámkový blok běží pod identitou naposledy upraveného uživatele kanálu, ne vlastníkem kanálu ani vlastníkem poznámkového bloku. To znamená, že každý, kdo kanál naposledy upravil, určuje kontext zabezpečení pro access dat, volání rozhraní API a oprávnění.
• Plánovač: Spuštění je iniciováno plánovaným během. Poznámkový blok běží pod identitou uživatele, který harmonogram vytvořil nebo naposledy aktualizoval.

Automatizace spouštění prostřednictvím rozhraní API

Také můžete spouštět poznámkové bloky na vyžádání přes API plánovače úloh. Spouštění aktivované rozhraním API podporují parametrizované spouštění, konfiguraci relace (například virtuální výpočetní jednotky a nastavení Sparku), výběr prostředí a modulu runtime a výběr cílového Fabric Lakehouse. Stav spuštění můžete monitorovat a zrušit instance úloh prostřednictvím stejného rozhraní API. Spuštění vrátí návratovou hodnotu, kterou mohou externí plánovače a pipelines číst pro aktivaci podmíněné orchestrace a následné signalizace.

Rozhraní REST API položek i rozhraní API plánovače úloh podporují ověřování instančního objektu pro zabezpečenou bezobslužnou automatizaci a CI/CD. Upozorňujeme, že některé podřízené služby (například koncové body T-SQL) nepodporují služební principálové a vyžadují uživatelský principál.

Tyto možnosti spouštění poskytují flexibilitu pro různé scénáře, ale musíte pochopit, která identita spouští váš poznámkový blok. Kontext zabezpečení ovlivňuje oprávnění pro přístup k datům, autorizaci volání rozhraní API a dostupnost prostředků.

Při prvním vytvoření poznámkového bloku se zobrazí zpráva s upozorněním, která vám připomene riziko spuštění kódu bez kontroly.

Pokud se chcete vyhnout problémům se zabezpečením, postupujte podle těchto osvědčených postupů:

• Před ručním spuštěním poznámkového bloku zkontrolujte, kdo poznámkový blok naposledy upravil, a pomocí panelu historie verzí zkontrolujte skutečné změny obsahu před spuštěním kódu, který jste nenapsali.
• Před přidáním poznámkového bloku do kanálu: Ověřte, kdo kanál naposledy upravil, protože poznámkový blok běží pod identitou daného uživatele. Otevřete poznámkový blok z pipeline a zkontrolujte jeho nejnovější obsah. Pokud identita nemá požadovaná oprávnění (nebo pokud potřebujete uživatelský účet místo služebního účtu pro určitá rozhraní API), nechte příslušného uživatele upravit pipeline tak, aby aktualizoval identitu použitou při poslední úpravě.
• Před vytvořením nebo aktualizací plánu: Poznámkový blok běží pod identitou toho, kdo plán vytvoří nebo aktualizuje. Ujistěte se, že má uživatel potřebná oprávnění pro všechny operace v poznámkovém bloku.
• Používejte fáze pracovního prostředí: Rozdělte pracovní prostory do fází vývoje, testování a produkce. Omezit přístup do produkčních pracovních prostorů pouze pro důvěryhodné uživatele.

Vytvořte poznámkové bloky

Můžete buď vytvořit nový poznámkový blok, nebo importovat existující poznámkový blok.

Vytvoření nového poznámkového bloku

Stejně jako u jiných standardních procesů vytváření položek Fabric můžete snadno vytvořit nový poznámkový blok z domovské stránky Fabric Datové inženýrství, možnosti Nový v pracovním prostoru nebo z Centra Vytvoření.

Podrobné pokyny k vytváření poznámkových bloků v konkrétních pracovních postupech najdete tady:

• Prozkoumejte data ve vašem lakehouse pomocí notebooku pro vytvoření notebooku z kontextu lakehouse na portálu Fabric.
• Autorské poznámkové bloky v Microsoft Fabric s Visual Studio Code pro vytváření autorských poznámkových bloků z VS Code.
• Veřejná rozhraní API pro poznámkové bloky pro vytváření a správu poznámkových bloků prostřednictvím rozhraní REST API položek (operace CRUD).
• Spouštět poznámkové bloky prostřednictvím rozhraní API plánovače úloh pro provádění poznámkových bloků na vyžádání s možností parametrizace, konfigurací relace, výběrem prostředí a Lakehouse, sledováním běhu a možností zrušení.

Importovat stávající poznámkové bloky

Pomocí položky na panelu nástrojů pracovního prostoru můžete importovat jeden nebo více existujících poznámkových bloků z místního počítače. Fabric poznámkové bloky rozpoznávají standardní soubory Jupyter Notebook .ipynb, a také zdrojové soubory jako .py, .scala a .sql, a odpovídajícím způsobem vytváří nové položky poznámkového bloku.

Exportovat poznámkový blok

Notebook můžete exportovat do jiných standardních formátů. Poznámkový blok Fabric je možné exportovat do:

Uložení poznámkového bloku

V Fabric se poznámkový blok po otevření a úpravě automaticky uloží. Nemusíte se starat o ztrátu změn kódu. Pomocí příkazu Uložit kopii můžete také naklonovat jinou kopii v aktuálním pracovním prostoru nebo do jiného pracovního prostoru.

Pokud chcete poznámkový blok uložit ručně, můžete přepnout na možnost Ruční uložení, abyste měli místní větev položky poznámkového bloku, a pak změny uložte pomocí kláves Uložit nebo CTRL+s .

Můžete také přepnout do režimu ručního ukládání výběrem možnosti Upravit ->Uložit ->Ruční. Pokud chcete zapnout místní větev poznámkového bloku a pak ho uložit ručně, vyberte Uložit nebo použijte klávesovou zkratku Ctrl+s .

Připojení lakehouse a notebooků

Fabric notebooky nyní podporují těsné interakce s lakehousemi. Z průzkumníka Lakehouse můžete snadno přidat nový nebo existující lakehouse.

V Průzkumníku Lakehouse můžete přejít na jiné jezero a nastavit ho jako výchozí připnutím. Výchozí nastavení je pak připojeno k pracovnímu adresáři runtime, a můžete číst nebo zapisovat do výchozího úložiště Lakehouse pomocí místní cesty.

Poznámka:

Po připnutí nového jezera nebo přejmenování výchozího jezera musíte relaci restartovat.

Přidejte nebo odeberte dům u jezera

Výběrem ikony X vedle názvu lakehouse ho odeberete z karty poznámkového bloku, ale položka lakehouse stále existuje v pracovním prostoru.

Vyberte Přidat lakehouse k přidání dalších lakehouse k poznámkovému bloku, buď přidáním existujícího lakehouse, nebo vytvořením nového.

Prozkoumejte soubor lakehouse

Podsložky a soubory v sekci Tabulky a Soubory zobrazení Jezero se zobrazují v oblasti obsahu mezi seznamem lakehouse a obsahem poznámkového bloku. Výběrem různých složek v části Tabulky a Soubory aktualizujte oblast obsahu.

Operace se složkami a soubory

Pokud vyberete soubor (.csv,.parquet,.txt,.jpg,.pngatd.) kliknutím pravým tlačítkem myši, můžete k načtení dat použít rozhraní API Spark nebo Pandas. Nová buňka kódu se vygeneruje a vloží pod buňku fokusu.

Cestu můžete snadno zkopírovat v jiném formátu než ve vybraném souboru nebo složce a použít odpovídající cestu v kódu.

Prostředky poznámkového bloku

Průzkumník zdrojů poznámkového bloku poskytuje Unixový souborový systém, který vám pomůže spravovat složky a soubory. Nabízí zapisovatelný prostor systému souborů, ve kterém můžete ukládat malé soubory, jako jsou moduly kódu, sémantické modely a obrázky. V poznámkovém bloku můžete snadno přistupovat k nim pomocí kódu, jako byste pracovali s místním systémem souborů.

Poznámka:

• Maximální velikost úložiště prostředků pro integrovanou složku i složku prostředí je 500 MB s jedinou velikostí souboru až 100 MB. Oba umožňují celkem až 100 instancí souborů a složek.
• Při použití notebookutils.notebook.run() použijte příkaz notebookutils.nbResPath k přístupu k cílovému prostředku poznámkového bloku. Relativní cesta vestavěná/ bude vždy odkazovat na vestavěnou složku kořenového poznámkového bloku.

Poznámka:

Soubory ve složce Resources (integrované i integrované prostředí) a knihovny nainstalované prostřednictvím vložených příkazů (například %pip install nebo install.packages()) jsou vymezeny na aktuální relaci poznámkového bloku. Nejsou ovlivněny publikováním prostředí, ať už v rychlém režimu, nebo v plném režimu.

Vestavěná složka prostředků

Vestavěná složka prostředků je systémově definovaná složka jedinečná pro každý notebook. Je doporučeno použít vestavěnou složku prostředků k uložení všech dat použitých v aktuálním poznámkovém bloku. Tady jsou klíčové funkce pro prostředky poznámkového bloku.

• Můžete použít běžné operace, jako je vytvoření, odstranění, nahrávání, stahování, přetažení, přejmenování, duplikování a vyhledávání v uživatelském rozhraní.
• K rychlému prozkoumání můžete použít relativní cesty jako builtin/YourData.txt. Tato notebookutils.nbResPath metoda vám pomůže sestavit úplnou cestu.
• Ověřená data můžete snadno přesunout do jezera prostřednictvím možnosti Zapisovat do jezera . Fabric vloží bohaté fragmenty kódu pro běžné typy souborů, které vám pomůžou rychle začít.
• Tyto prostředky jsou také k dispozici pro použití při spuštění referenčního poznámkového bloku prostřednictvím notebookutils.notebook.run().

Složka zdrojů prostředí

Složka Prostředí je sdílené úložiště navržené tak, aby zjednodušilo spolupráci napříč několika poznámkovými bloky.

• Kartu Prostředky najdete uvnitř prostředí a všechny operace pro správu souborů prostředků máte k dispozici zde. Tyto soubory je možné sdílet napříč několika poznámkovými bloky, jakmile je poznámkový blok připojený k aktuálnímu prostředí.

  

• Na stránce Poznámkový blok můžete snadno najít druhou kořenovou složku v části Prostředky zděděné z připojeného prostředí.

  

• Můžete také pracovat se soubory nebo složkami stejnými se složkou Předdefinovaných prostředků.

• Cesta k prostředkům prostředí je automaticky připojena ke clusteru poznámkových bloků. K přístupu k prostředkům prostředí můžete použít relativní cestu /env.

Fabric prostředí podporují dva režimy publikování knihoven, které ovlivňují způsob doručení knihoven do relací poznámkového bloku:

• Rychlý režim se publikuje přibližně za 5 sekund a při zahájení relace poznámkového bloku nainstaluje knihovny. Rychlý režim může přepsat verze knihoven publikované prostřednictvím režimu Full, ale pouze pro aktuální relaci.
• Úplný režim vytvoří stabilní a reprodukovatelný snímek knihovny. Publikování obvykle trvá 3 až 6 minut a zahájení relace vyžaduje 1 až 3 minuty pro nasazení závislostí. Použití režimu Full s vlastním živým fondem může přinést časy spuštění relace zpět na přibližně 5 sekund při zachování stabilního snímku.

Podrobnosti o jednotlivých režimech najdete v tématu Spravování knihoven v prostředích Fabric.

Použití knihoven prostředí v poznámkových blocích

Zvolte režim publikování pro knihovnu na základě svého pracovního postupu:

• Rychlý režim pro iterativní vývoj: Rychlý režim používejte, když aktivně experimentujete v poznámkových blocích a potřebujete rychlou iteraci knihovny. Knihovny se instalují při spuštění relace s minimální dobou publikování.
• Úplný režim pro reprodukovatelnost: Úplný režim použijte, pokud potřebujete konzistentní verze knihoven mezi spolupracovníky, naplánované běhy nebo úlohy v pipeline. Snímek zajišťuje, že každá relace začíná se stejnými závislostmi na začátku.
• Plný režim s vlastním živým fondem pro rychlé a stabilní relace: Při rychlém spuštění relace a reprodukovatelnosti nakonfigurujte režim Full s vlastním živým fondem. Tato kombinace umožňuje spuštění relací přibližně za 5 sekund, přičemž zachovává stabilní snímek knihovny.

Poznámka:

Čtení a zápis s relativní cestou nefunguje v vysoce souběžné relaci.

Editor souborů

Editor souborů umožňuje zobrazovat a upravovat soubory přímo ve složce prostředků poznámkového bloku a ve složce prostředků prostředí v poznámkovém bloku. Mezi podporované typy souborů patří CSV, TXT, HTML, YML, PY, SQL a další. Pomocí editoru souborů můžete snadno access a upravovat soubory v poznámkovém bloku, podporuje zvýraznění klíčových slov a poskytuje potřebnou jazykovou službu při otevírání a úpravách souborů kódu, jako je .py a .sql.

• K této funkci můžete přistupovat prostřednictvím 'View and edit' v nabídce Soubor. Dvakrát kliknutí na soubor je rychlejší způsob.

  

• Změnu obsahu v editoru souborů je potřeba uložit ručně kliknutím na tlačítko Uložit nebo klávesovou zkratkou: Ctrl+S, editor souborů nepodporuje automatické ukládání.

• režim poznámkového bloku má vliv také na editor souborů. Soubory můžete jenom zobrazit, ale nemůžete je upravovat, pokud jste v režimu poznámkového bloku bez oprávnění k úpravám.

Poznámka:

Tady jsou některá omezení pro editor souborů.

• Limit velikosti souboru je 1 MB.
• Tyto typy souborů nejsou podporovány pro zobrazení a úpravy: .xlsx a .parquet.

Spolupracujte v poznámkovém bloku

Poznámkový blok Fabric je položka pro spolupráci, která podporuje úpravy stejného poznámkového bloku více uživatelům.

Když otevřete poznámkový blok, ve výchozím nastavení přejdete do režimu spoluvytváření a každá úprava poznámkového bloku se automaticky uloží. Pokud vaši kolegové současně otevřou stejný poznámkový blok, uvidíte jejich profil, výstup běhu, ukazatel kurzoru, indikátor výběru a stopu úprav. Pomocí funkcí pro spolupráci můžete snadno provádět párové programování, vzdálené ladění a scénáře doučování.

Použijte Copilot v poznámkových blocích

Copilot je okamžitě kontextově informován o pracovním prostoru, připojených schématech Lakehouse, tabulkách a souborech, struktuře poznámkového bloku a aktuálním stavu modulu runtime. Nemusíte zahajovat relaci, aby vám Copilot pomohla. Copilot podporuje generování kódu v celém poznámkovém bloku, refaktoring, shrnutí a ověřování napříč celými pracovními postupy, takže můžete pracovat napříč buňkami bez ztráty kontextu.

Přehledy výkonu z Copilot

Copilot zobrazuje doporučení pro výkon na základě velikosti dat, způsobů spojení a chování za běhu. Může například doporučit efektivní strategie spojení, pomoci vyhnout se nákladným přesunům dat, navrhnout refaktoring na opakovaně použitelné funkce a zvýraznit potenciální problémy s kvalitou dat zjištěné během spuštění. Tyto přehledy se zobrazí jako součást konverzací Copilot a odpovídají příkazu /optimize.

Řešení potíží s Copilot

Pokud se buňka nebo úloha Sparku nezdaří, zobrazí se pod nezdařenou buňkou možnost Oprava s Copilotem. Poskytuje souhrn chyb, analýzu původní příčiny a doporučené opravy. Copilot může automaticky použít změny kódu s možností schválení, abyste je mohli zkontrolovat před potvrzením. Pomocí příkazu /fix v Copilot chatu můžete také spustit cílovou diagnostiku pro konkrétní buňku nebo celý poznámkový blok. Další informace najdete v Diagnostice selhání v poznámkovém bloku s pomocí Copilot.

Sdílení poznámkového bloku

Sdílení poznámkového bloku je pohodlný způsob, jak spolupracovat s členy týmu. Autorizované role pracovního prostoru můžou ve výchozím nastavení zobrazovat nebo upravovat nebo spouštět poznámkové bloky. Poznámkový blok můžete sdílet se zadanými oprávněními udělenými.

1. Na panelu nástrojů poznámkového bloku vyberte Sdílet .

   

2. Vyberte odpovídající kategorii lidí, kteří můžou tento poznámkový blok zobrazit. Pro příjemce můžete zvolit oprávnění Sdílet, Upravit nebo Spustit .

   

3. Po výběru možnosti Použít můžete poznámkový blok poslat přímo nebo zkopírovat odkaz ostatním. Příjemci pak můžou poznámkový blok otevřít s odpovídajícím zobrazením uděleným úrovní oprávnění.

   

4. Pokud chcete oprávnění poznámkového bloku dál spravovat, vyberte Seznam>položek pracovního prostoru Další možnosti a pak vyberte Spravovat oprávnění. Na této obrazovce můžete aktualizovat přístup a oprávnění existujícího poznámkového bloku.

   

Okamžitě okomentujte buňku kódu

Komentování je další užitečnou funkcí pro scénáře spolupráce. V současné době Fabric podporuje přidávání komentářů na úrovni buněk.

1. Výběrem tlačítka Komentáře na panelu nástrojů poznámkového bloku nebo indikátorem komentáře buňky otevřete podokno Komentáře.

   

2. Vyberte kód v buňce kódu, v podokně Komentáře vyberte Nový, přidejte komentáře a pak vyberte Publikovat komentář, který chcete uložit.

   

3. Pokud je potřebujete, vyhledejte možnosti Upravit komentář, Vyřešit vlákno a Odstranit vlákno výběrem možnosti Další vedle komentáře.

Označování ostatních v komentáři

Označení odkazuje na zmínku a upozorňování uživatele ve vlákně komentáře, což efektivně vylepšuje spolupráci na konkrétních specifikách.

1. Vyberte část kódu v buňce a vytvořte nové vlákno komentářů.

2. Zadejte uživatelské jméno a v seznamu návrhů zvolte správné jméno, pokud chcete někoho zmínit v diskuzi o určité části.

3. Sdílejte přehledy a publikujte je.

4. Aktivuje se e-mailové oznámení a uživatel klikne na odkaz Otevřít komentáře pro rychlé vyhledání této buňky.

5. Kromě toho povolte a nakonfigurujte oprávnění pro uživatele při označování osob, které nemají access, a ujistěte se, že jsou vaše prostředky kódu dobře spravované.

Poznámka:

U položky komentáře už označený uživatel neobdrží e-mailové oznámení, pokud komentář aktualizujete do jedné hodiny. Ale pošle e-mailové oznámení novému označenému uživateli.

Historie verzí

Důležité

Tato funkce je ve verzi Preview.

Historie verzí vám umožňuje snadno spravovat verze změn ve vašem aktivním poznámkovém bloku. Podporuje sledování historie a správu poznámek s robustními vestavěnými možnostmi řízení verzí, což je obzvláště užitečné pro spolupráci s více přispěvateli na stejných poznámkách.

1. Přistupte k verzi historie z globálního panelu nástrojů notebooku.

   

2. Notebook podporuje dva způsoby vytváření kontrolních bodů.

   • Ruční kontrolní bod: Můžete ručně vytvořit novou verzi pro zaznamenání milníků vývoje, čímž získáte flexibilitu při správě verzí poznámkových bloků.

     

   • Kontrolní bod systému: Tyto kontrolní body se vytvářejí automaticky každých 5 minut na základě úprav časového intervalu systémem poznámkového bloku a zajišťují konzistentní ukládání a správu verzí vaší práce. Záznamy změn od všech přispěvatelů najdete v seznamu časové osy kontrolních bodů systému.

3. Vytváření kontrolních bodů z více zdrojů pro notebook

   Poznámkové bloky Fabric se bezproblémově integrují s nástrojem Git, nasazovacími kanály a Visual Studio Code. Každá uložená verze se automaticky zaznamenává v historii verzí poznámkového bloku. Verze můžou pocházet z přímých úprav v rámci poznámkového bloku, Git synchronizací, činností v kanálu nasazení nebo publikování prostřednictvím VS Code. Zdroj každé verze je jasně označený v historii verzí, aby byla zajištěna úplná sledovatelnost.

   

4. Kliknutím na kontrolní bod můžete otevřít rozdílové zobrazení, které zvýrazňuje rozdíly mezi vybraným kontrolním bodem a aktuální živou verzí, včetně rozdílů v obsahu buněk, výstupech buněk a metadat. Verzi tohoto kontrolního bodu je možné spravovat jednotlivě v nabídce "další možnosti".

   zobrazení

5. Verzi můžete spravovat z rozevírací nabídky kontrolního bodu, pokud chcete zachovat předchozí verzi, klikněte na obnovit z kontrolního bodu a přepište aktuální poznámkový blok nebo ho pomocí příkazu Uložit jako kopii naklonujte do nového poznámkového bloku.

   

Poznámka:

• Známé omezení: Pokud některé z nich klikne na tlačítko Obnovit a pak přejde zpět do poznámkového bloku, poznámkový blok se okamžitě neobnoví z kontrolního bodu. Panel zpráv vás vyzve k zobrazení změn. Musíte kliknout na tlačítko Zobrazit změny a zvolit možnost ponechat Uloženou verzi, abyste dokončili obnovení.
• Platnost kontrolních bodů systému vyprší po 1 roce.

Přepínač režimu notebooku

Poznámkové bloky Fabric podporují čtyři režimy, mezi kterými můžete přepínat: Vyvíjet, Spouštět jenom, Upravit a Zobrazit. Každý režim odpovídá sadě oprávnění.

Když sdílíte poznámkový blok, přiřadíte uživatelům oprávnění. Na základě těchto oprávnění můžou uživatelé přistupovat k režimům, které jsou jim k dispozici, a přepínat mezi nimi.

• Režim vývoje: Vyžaduje oprávnění ke čtení, spouštění a zápisu.
• Spustit pouze režim: Vyžaduje oprávnění ke čtení a spuštění.
• Režim úprav: Vyžaduje oprávnění ke čtení a zápisu (nelze spustit).
• Režim zobrazení: Vyžaduje oprávnění ke čtení.

Oprávnění a přístup

Oprávnění je možné nastavit na úrovni pracovního prostoru nebo poznámkového bloku v Microsoft Fabric. Určují režimy, ke kterým má uživatel přístup:

• Oprávnění omezují sadu dostupných režimů.
• Nevybírejí automaticky režim pro uživatele.
• Režimy nemůžou udělovat možnosti nad rámec povolených oprávnění.

Související obsah

• Vytváření a spouštění poznámkových bloků
• Přehled Copilot pro datové inženýrství a datové vědy
• Spravujte knihovny v prostředích Fabric
• Diagnostikujte selhání notebooku s Copilot
• Referenční informace k rozhraní REST API plánovače úloh