Sdílet prostřednictvím


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í plochu, kterou používají datoví vědci a datoví inženýři k psaní kódu, který využívá bohaté vizualizace a text 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í řešení strojového uč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 potřeby 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.

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

Spuštění poznámkového bloku lze aktivovat třemi různými způsoby ve Fabric s plnou flexibilitou pro různé scénáře.

  • Interaktivní spuštění: Uživatel ručně aktivuje provádění prostřednictvím různých položek uživatelského rozhraní nebo volání rozhraní REST API. Provádění by probíhalo v kontextu zabezpečení aktuálního uživatele.
  • Spustit jako aktivita kanálu: Spuštění se aktivuje z kanálu Fabric Data Factory. Podrobné kroky najdete v aktivitě sešitu. Spuštění bude probíhat v rámci zabezpečení vlastníka kanálu.
  • Plánovač: Spuštění se aktivuje z plánu plánovače. Spuštění by bylo spuštěno v kontextu zabezpečení uživatele, který nastavil nebo aktualizoval plán plánovače.

Flexibilita těchto možností spouštění s různým kontextem zabezpečení umožňuje splnit různé scénáře a požadavky, ale také vyžaduje uvědomění si kontextu zabezpečení při návrhu a vývoji poznámkového bloku, jinak by to mohlo vést k neočekávanému chování a dokonce i některým problémům se zabezpečením.

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.

Snímek obrazovky s upozorněním na spuštění poznámkového bloku

Tady je několik osvědčených postupů, které vám pomůžou vyhnout se problémům se zabezpečením:

  • Než poznámkový blok spustíte ručně, otevřete nastavení poznámkového bloku a zkontrolujte část Detaily v panelu Informace pro aktualizaci změn, ujistěte se, že souhlasíte s nejnovější změnou.
  • Než přidáte aktivitu poznámkového bloku do pipeline, otevřete nastavení poznámkového bloku a zkontrolujte sekci Podrobnosti na panelu O, kde je aktualizace úprav. Ujistěte se, že jste spokojeni s nejnovější změnou. Pokud si nejste jistí nejnovější změnou, je lepší otevřít poznámkový blok a zkontrolovat změnu předtím, než ji přidáte do potrubí.
  • Než plán plánovače aktualizujete, otevřete nastavení poznámkového bloku a zkontrolujte část Podrobnosti na panelu Informace o aktualizaci úprav, ujistěte se, že jste v pořádku s nejnovější změnou. Pokud si nejste jistí nejnovější změnou, raději otevřete Poznámkový blok a kontrolujte změnu, než aktualizujete plán v plánovači.
  • Rozdělte pracovní prostor do jiné fáze (vývoj, testování, prod) a kontrolujte přístup různých fází, abyste se vyhnuli problému se zabezpečením. Přidejte pouze uživatele, kterému důvěřujete, do fáze prod.

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í technici, možnosti Nový pracovní prostor nebo Vytvořit centrum.

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. Poznámkové bloky Fabric rozpoznávají standardní soubory Jupyter Notebook .ipynb a zdrojové soubory, jako jsou .py, .scala, a .sql, a vytvářejí nové položky poznámkových bloků odpovídajícím způsobem.

Snímek obrazovky znázorňující, kde najít možnosti poznámkového bloku v nabídce Nový

Export poznámkového bloku

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

  • Standardní soubor poznámkového bloku (.ipynb), který se používá pro poznámkové bloky Jupyter.
  • Soubor HTML (.html), který lze otevřít přímo v prohlížeči.
  • Soubor Pythonu (.py).
  • Soubor LaTeX (.tex).

Snímek obrazovky znázorňující, kam se má poznámkový blok exportovat

Uložení poznámkového bloku

V Fabric se poznámkový blok ve výchozím nastavení automaticky uloží poté, co jej otevřete a upravíte; nemusíte se obávat ztráty 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.

Snímek obrazovky znázorňující, kam uložit kopii

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 .

Snímek obrazovky znázorňující, kam přepnout ruční ukládání

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 poznámkových bloků

Poznámkové bloky Fabric nyní podporují úzké interakce s Lakehouse; nový nebo existující Lakehouse můžete snadno přidat z Průzkumníka pro 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.

Snímek obrazovky znázorňující, kam připnout výchozí lakehouse

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.

Snímek obrazovky s místní nabídkou souborů v lakehouse.

Prostředky poznámkového bloku

Průzkumník prostředků poznámkového bloku poskytuje systém souborů podobný systému Unix, 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. K nim můžete snadno přistupovat pomocí kódu v poznámkovém bloku, jako kdybyste pracovali s místním systémem souborů.

animovaný obrázek GIF zdrojů poznámkového bloku.

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 pro přístup k cílovému prostředku poznámkového bloku. Relativní cesta předdefinovaná/ bude vždy odkazovat na integrovanou složku kořenového poznámkového bloku.

Vestavěná složka prostředků

Vestavěná složka prostředků je systémově definovaná složka jedinečná pro každý notebook. K ukládání všech dat používaných v aktuálním poznámkovém bloku doporučujeme použít integrovanou složku prostředků. 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 vytvořit úplnou cestu.
  • Ověřená data můžete snadno přesunout do jezera prostřednictvím možnosti Zapisovat do jezera . Nástroj Fabric vkládá bohaté fragmenty kódu pro běžné typy souborů, které vám pomohou 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ředků prostředí je sdílené úložiště navržené tak, aby zjednodušily 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í.

    Snímek obrazovky znázorňující, kde spravovat prostředky v 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í.

    Snímek obrazovky znázorňující, kde otevřít složku prostředků 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.

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 přistupovat k souborům v poznámkovém bloku a upravovat je, 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 jsou .py a .sql.

  • K této funkci se dostanete prostřednictvím možnosti Zobrazit a upravit v nabídce souboru. Dvakrát kliknutí na soubor je rychlejší způsob.

    Snímek obrazovky znázorňující, kde se mají zobrazovat a upravovat soubory

  • 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 více uživatelů, kteří upravují stejný poznámkový blok.

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

Snímek obrazovky zobrazující buňku kódu s úpravou jiného uživatele

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 .

    Snímek obrazovky znázorňující, kde vybrat 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 .

    Snímek obrazovky znázorňující, kde vybrat oprávnění

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

    Snímek obrazovky znázorňující, kde vytvořit a odeslat odkaz

  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 stávající přístup a oprávnění k poznámkovému bloku.

    Snímek obrazovky znázorňující, kde spravovat oprávnění v pracovním prostoru

Okamžitě okomentujte buňku kódu

Komentování je další užitečnou funkcí pro scénáře spolupráce. Aktuálně 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.

    Snímek obrazovky znázorňující, kde vybrat komentář

  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.

    Snímek obrazovky znázorňující, kde vybrat Nový

  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 zvolte správné jméno v seznamu návrhů, pokud chcete někoho zmínit pro 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í uživatele, který nemá přístup, a ujistěte se, že jsou vaše prostředky kódu dobře spravované.

animovaný gif označování ostatních v komentáři.

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í

Poznámka:

V současné době je tato funkce 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řístup k historii verzí z globálního panelu nástrojů v zápisníku.

    Snímek obrazovky zobrazující přístup k historii

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

      Snímek obrazovky znázorňující, jak vytvořit novou verzi

    • 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. Snímek obrazovky zobrazující rozbalovací seznam kontrolních bodů

  3. 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".

    Snímek obrazovky zobrazující rozdíl zobrazení

  4. 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řepsat aktuální poznámkový blok, nebo pomocí uložit jako kopii ji naklonovat do nového poznámkového bloku.

    Snímek obrazovky s dalšími možnostmi kontrolního bodu

Poznámka:

  • Známé omezení: Po stisknutí tlačítka Obnovit a následném přechodu zpět do poznámkového blokuse poznámkový blok 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í. Snímek obrazovky zobrazující změny zobrazení po 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, které můžete snadno přepínat: Vývojový režim, Režim pouze spuštění, Režim úprav, a Režim zobrazení. Každý režim se mapuje na konkrétní kombinaci oprávnění. Při sdílení poznámkového bloku s ostatními členy týmu můžete příjemcům udělit správná oprávnění. Podle svého oprávnění vidí nejlepší dostupný režim poznámkového bloku a můžou přepínat mezi režimem, ke kterým mají oprávnění.

Snímek obrazovky znázorňující, kde se přepínají režimy

  • Režim vývoje: Potřebujete oprávnění ke čtení, spouštění a zápisu.
  • Pouze režim spuštění: Je potřeba oprávnění ke čtení a spuštění.
  • Režim úprav: Vyžaduje se oprávnění ke čtení, zápisu.
  • Režim zobrazení: Potřebujete oprávnění ke čtení.