Základní úpravy v poznámkových blocích Databricks

Poznámkový blok Databricks je webový editor kódu, který umožňuje psaní kódu a zobrazování výsledků pro interaktivní analýzu dat. Tato stránka popisuje základy používání poznámkových bloků v Databricks, včetně navigování pomocí panelu nástrojů a provádění různých akcí s buňkami.

Vytvořte poznámkový blok

Nový poznámkový blok můžete vytvořit několika způsoby:

• Použití tlačítka Nový na bočním panelu
• Vytvoření poznámkového bloku v libovolné složce
• Vytvořte poznámkový blok na nové kartě

Otevření poznámkového bloku

Pokud chcete otevřít poznámkový blok, použijte funkci Hledání pracovního prostoru nebo pomocí prohlížeče pracovního prostoru přejděte do poznámkového bloku a klikněte na název nebo ikonu poznámkového bloku.

Pokud máte záložky pro poznámkové bloky a soubory povolené, můžete otevřít poznámkový blok na nové záložce.

Upravovat poznámkové bloky vedle sebe

Pokud chcete zobrazit a upravit poznámkové bloky vedle sebe, klikněte na Pokud chcete přidat rozdělené zobrazení aktuálního poznámkového bloku. Kartu poznámkového bloku můžete také přetáhnout doprava, abyste mohli poznámkové bloky upravovat vedle sebe.

Buňky poznámkového bloku

Poznámkové bloky obsahují kolekci dvou typů buněk: buňky kódu a buňky Markdownu. Buňky kódu obsahují spustitelný kód. Buňky Markdownu obsahují kód Markdownu, který se vykreslí jako text a grafika. Pomocí Markdownu můžete dokumentovat nebo ilustrovat kód. Chcete-li strukturovat svou práci, můžete do poznámkového bloku přidat nebo odebrat buňky obou typů. Poznámkový blok může obsahovat až 10 000 buněk.

Můžete spustit jednu buňku, skupinu buněk nebo celý poznámkový blok. Buňka poznámkového bloku může obsahovat maximálně 6 MB a jeho výstup je omezený na 20 MB.

Ikony a tlačítka panelu nástrojů poznámkového bloku

Panel nástrojů obsahuje nabídky a ikony, které můžete použít ke správě a úpravám poznámkového bloku.

Vedle názvu poznámkového bloku jsou tlačítka pro změnu jeho výchozího jazyka a pro otevření dialogového okna Git, pokud je poznámkový blok součástí složky Git Databricks.

Pokud chcete zobrazit předchozí verze poznámkového bloku, klikněte na "Poslední úpravy…" zpráva napravo od menu.

Ikony a tlačítka napravo od panelu nástrojů jsou popsány v následující tabulce:

Icon	Description
	Spustit všechny buňky nebo ukončit spuštění. Název tohoto tlačítka se změní v závislosti na stavu poznámkového bloku.
	Otevřete selektor výpočetních prostředků. Když je poznámkový blok připojený ke clusteru nebo SQL warehouse, zobrazí se na tomto tlačítku název výpočetního prostředku.
	Otevřete plánovače úloh.
	Otevřete deklarativní kanály Sparku pro Lakeflow. Toto tlačítko se zobrazí pouze v případě, že je poznámkový blok součástí pipeline.
	Otevřete dialogové okno oprávnění.

Akce na pravém postranním panelu

Na pravém bočním panelu poznámkového bloku je k dispozici několik akcí, jak je popsáno v následující tabulce:

Icon	Description
	Otevřete komentářev poznámkovém bloku .
	Otevřete experiment v poznámkovém bloku MLflow.
	Otevřete historii verzí poznámkového bloku .
	Otevřete průzkumníka proměnných. (K dispozici pro proměnné Pythonu v Databricks Runtime 12.2 LTS a novějších verzích.)
	Otevřete panel prostředí Pythonu. Tento panel zobrazuje všechny knihovny Pythonu dostupné pro poznámkový blok, včetně knihoven vymezených poznámkovým blokem, knihoven clusteru a knihoven zahrnutých v modulu Databricks Runtime. K dispozici pouze v případech, kdy je poznámkový blok připojený ke clusteru.

Vytvoření buněk

Notebooky mají dva typy buněk: kód a Markdown.

Pokud chcete vytvořit novou buňku, najeďte myší na buňku v horní nebo dolní části. Kliknutím na +Kód nebo +Text vytvořte kód nebo buňku Markdown.

Ve výchozím nastavení buňka kódu předpokládá jazyk kódu poznámkového bloku zadaný v horní části stránky. Pokud chcete kombinovat jazyky, můžete pro buňku zadat jiný jazyk. Viz Nastavení výchozího jazyka.

Obsah buněk Markdownu se vykreslí do HTML. Tento fragment kódu například obsahuje značky pro nadpis úrovně 1:

%md ### Libraries
Import the necessary libraries.

Zobrazí se takto:

Pokud chcete vytvořit novou buňku, najeďte myší na buňku v horní nebo dolní části. Kliknutím na Kód nebo Text vytvořte kód nebo markdownovou buňku.

Akce buňky

Na buňce můžete provádět různé akce. Nabídka spuštění buňky vám umožňuje vybrat, zda chcete spustit buňku, všechny buňky nad ní nebo všechny buňky pod ní. K dispozici jsou ikony buněk, které umožňují rychle změnit kódovací jazyk, odstranit buňku a získat přístup k asistentovi. Nabídka akcí buňky umožňuje vyjmout a kopírovat buňky, přesouvat buňky v poznámkovém bloku a skrýt kód nebo výsledky v buňce.

Spusťte buňku

Pokud chcete spustit buňku kódu, klikněte na šipku vpravo v levém horním rohu buňky. Chcete-li získat přístup k nabídce spuštění buňky, klikněte na šipku dolů vedle ní a vyberte kontext, ve kterém chcete buňku spustit.

Po spuštění buňky se napravo od nabídky spuštění buňky zobrazí oznámení, které ukazuje čas posledního spuštění buňky a její dobu trvání. Další podrobnosti zobrazíte tak, že najedete myší na upozornění.

Pokud chcete ve výchozím nastavení zobrazit podrobné informace o spuštění, klikněte na svůj profilový obrázek v pravém horním rohu. Potom klikněte na Nastavení>Vývojář>Zobrazit podrobné informace o spuštění příkazu.

Pokud máte výstup tabulkového výsledku, můžete k informacím získat přístup také tak, že najedete myší na text Poslední aktualizace v pravém dolním rohu tabulky.

Spustit vybrané buňky

Můžete spustit jednu buňku nebo sbírku buněk. Chcete-li vybrat jednu buňku, klikněte myší kamkoli do buňky. Pokud chcete vybrat více buněk, podržte klávesu Command v systému MacOS nebo klávesu Ctrl ve Windows a klikněte na buňku mimo textová oblast, jak je znázorněno na snímku obrazovky.

Pokud chcete vybrané buňky spustit, klikněte na Spustit>Spustit a ladit>Spustit vybrané buňky nebo použijte klávesovou zkratku Command + Enter v systému MacOS nebo Crtl + Enter ve Windows. Chování tohoto příkazu závisí na výpočetním prostředku, ke kterému je poznámkový blok připojený.

• Na výpočetním prostředku, který používá Databricks Runtime 13.3 LTS nebo nižší, se vybrané buňky spouštějí jednotlivě. Pokud dojde k chybě v buňce, provádění pokračuje s dalšími buňkami.
• Na výpočetním prostředku, na kterém běží Databricks Runtime 14.0 nebo novější nebo ve službě SQL Warehouse, se vybrané buňky spouští jako dávka. Jakákoli chyba zastaví spouštění a nemůžete zrušit spuštění jednotlivých buněk. Spuštění všech buněk můžete zastavit použitím tlačítka Přerušení.

Spustit vybraný text

V buňce poznámkového bloku můžete zvýraznit kód nebo příkazy SQL a spustit pouze zvýrazněný kód. To je užitečné, když chcete rychle iterovat kód a dotazy.

1. Zvýrazněte řádky, které chcete spustit.

2. Vyberte Spustit > Spustit vybraný text nebo použijte klávesovou zkratku Ctrl+Shift+Enter. Pokud není zvýrazněn žádný text, Spustit vybraný text spustí aktuální řádek.

   

Pokud v buňcepoužíváte smíšené jazyky, musíte zahrnout řádek do výběru.

Spuštění vybraného textu také spustí sbalený kód, pokud je nějaký ve zvýrazněném výběru.

Podporují se speciální příkazy buněk, jako jsou %run, %pipa %sh.

Nelze použít Spustit vybraný text na buňkách s více výstupními kartami (to znamená buňky, ve kterých jste definovali datový profil nebo vizualizaci).

Ikony buněk

Následující snímek obrazovky popisuje ikony, které se zobrazí v pravém horním rohu buňky poznámkového bloku:

selektor jazyka: Vyberte jazyk buňky.

Odstranit buňku: Odstraňte buňku.

Databricks Assistant: Přepínejte otevření nebo zavření Databricks Assistant přímo uvnitř buňky kódu. Můžete zadat výzvu pro pomocníka, který vám pomůže vygenerovat kód.

Fokus buňky: Zvětšit buňku a usnadnit úpravy.

Zobrazit nabídku akcí buňky: Otevřít nabídku akcí buňky. Možnosti v této nabídce se u buněk kódu a Markdownu mírně liší.

Odstranění buňky

Pokud chcete buňku odstranit, klikněte na ikonu koše napravo od buňky. Tato ikona se zobrazí jenom v případě, že na buňku najedete myší.

Přesunutí buňky

Vlevo od buňky klikněte a držte ikonu přetažení, abyste buňku přesunuli nahoru nebo dolů.

V nabídce akcí buňky můžete také vybrat Přesunout nahoru nebo Přesunout dolů.

Vyjmout, kopírovat a vložit buňky

Existuje několik možností pro vyjmutí a kopírování buněk. Pokud ale používáte prohlížeč Safari, jsou k dispozici pouze klávesové zkratky.

• V nabídce akcí buňky vyberte Vyjmout buňku nebo Kopírovat buňku.
• Používejte klávesové zkratky: Command-X nebo Ctrl-X k vyjmutí a Command-C nebo Ctrl-C ke kopírování.
• V horní části poznámkového bloku použijte nabídku Edit. Vyberte Vyjmout nebo Kopírovat.

Po vyjmutí nebo zkopírování buněk můžete tyto buňky vložit jinam v poznámkovém bloku, do jiného poznámkového bloku nebo do poznámkového bloku otevřeného na jiné kartě nebo v jiném okně prohlížeče. K vložení buněk použijte klávesovou zkratku Command-V nebo Ctrl-V. Buňky jsou vloženy pod aktuální buňku.

Chcete-li vrátit zpět akce vyjmutí nebo vložení, můžete použít klávesovou zkratku Command-Z nebo Ctrl-Z, nebo možnosti nabídky Upravit > Vrátit vyjmutí buněk nebo Upravit > Vrátit vložení buněk.

Chcete-li vybrat sousední buňky, klikněte do buňky Markdownu a potom pomocí kláves Shift + Nahoru nebo Dolů vyberte buňky nad nebo pod ní. Pomocí nabídky pro úpravy můžete zkopírovat, vyjmout, vložit nebo odstranit vybrané buňky jako skupinu. Chcete-li vybrat všechny buňky, vyberte Upravit > Vyberte všechny buňky nebo použijte zástupce režimu příkazů Cmd+A.

Přidání komentářů ke kódu

Pokud chcete přidat komentář ke kódu v buňce, zvýrazněte kód. Napravo od buňky se zobrazí ikona komentáře. Kliknutím na ikonu otevřete pole komentáře.

Přidat buňku na řídicí panel

Pokud chcete přidat buňku Markdownu nebo buňku s tabulkovými výsledky na řídicí panel, vyberte Přidat do řídicího panelu v nabídce akcí buňky. Další informace najdete v Dashboardy v poznámkových blocích.

Propojení s buňkou

Pokud chcete v poznámkovém bloku získat odkaz na konkrétní příkaz, klikněte na , otevřete režim fokusu a zkopírujte adresu URL z adresního řádku prohlížeče. Pokud chcete ukončit režim zaměření, klikněte na ikonu ukončení fokusu buňky .

Chcete-li získat odkaz na adresu URL konkrétního příkazu v poznámkovém bloku, klikněte na čímž otevřete detailní režim, a zkopírujte adresu URL z adresního řádku prohlížeče. Chcete-li ukončit režim soustředění, klikněte na

Otevřít Asistenta Databricks

Pokud chcete otevřít textové pole Databricks Assistant v buňce, klikněte na ikonu Databricks Assistant V pravém horním rohu buňky.

Můžete ho použít v buňce kódu a získat nápovědu nebo návrhy kódu. Databricks Assistant musí být ve vašem pracovním prostoru povolený.