Rozhraní a ovládací prvky poznámkového bloku Databricks

Panel nástrojů poznámkového bloku 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, která umožňují změnit výchozí jazyk poznámkového bloku a pokud je poznámkový blok součástí složky Git Databricks, otevřete dialogové okno Git.

Pokud chcete zobrazit předchozí verze poznámkového bloku, klikněte na tlačítko Poslední úpravy... napravo od nabídek.

Aktualizace návrhu buňky

Důležité

Tato funkce je ve verzi Public Preview.

K dispozici je aktualizovaný návrh buňky. Tato stránka obsahuje informace o tom, jak používat obě verze návrhu buňky. Orientaci na nové uživatelské rozhraní a odpovědi na běžné otázky najdete v tématu Orientace na nové uživatelské rozhraní buňky.

Pokud chcete nový návrh buňky povolit nebo zakázat, otevřete stránku nastavení editoru v pracovním prostoru. Na bočním panelu klikněte na Vývojář. V části Experimentální funkce přepněte nové uživatelské rozhraní buňky.

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 při spuštění buňky vykreslí do textu a grafiky a dá se použít k dokumentování nebo ilustraci kódu. Do poznámkového bloku můžete přidat nebo odebrat buňky, abyste mohli strukturovat práci.

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

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

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

Ikona	Popis
	Spusťte všechny buňky nebo zastavte provádě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č úloh.
	Otevřete dynamické tabulky Delta. Toto tlačítko se zobrazí jenom v případě, že je poznámkový blok součástí kanálu Delta Live Tables.
	Otevření dialogového okna oprávnění

Akce pravého bočního 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:

Ikona	Popis
	Otevřete poznámkové bloky.
	Otevřete experiment poznámkového bloku MLflow.
	Otevřete historii verzí poznámkového bloku.
	Otevřete Průzkumníka proměnných. (K dispozici pro proměnné Pythonu s modulem Databricks Runtime 12.2 LTS a novějším.)
	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.

Procházet data

Důležité

Tato funkce je ve verzi Public Preview.

Pokud chcete prozkoumat tabulky a svazky dostupné pro použití v poznámkovém bloku, kliknutím na levou stranu poznámkového bloku otevřete prohlížeč schématu. Další podrobnosti najdete v tématu Procházet data .

Nabídka Akce buňky

Nabídka akcí v buňce 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. Nabídka má jiný vzhled v původním uživatelském rozhraní a novém uživatelském rozhraní. Tato část obsahuje pokyny pro obě verze.

Pokud je v pracovním prostoru povolen Nástroj Databricks Assistant, můžete ho použít v buňce kódu a získat nápovědu nebo návrhy kódu. 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.

Buňku můžete snadno změnit mezi kódem a markdownem nebo změnit jazyk buňky kódu pomocí tlačítka jazyka buňky v pravém horním rohu buňky.

Nabídka Akcí buňky (původní uživatelské rozhraní)

V této nabídce můžete také spouštět buňky kódu:

Nabídka akcí buňky obsahuje také tlačítka, která umožňují skrýt buňku nebo odstranit buňku .

U buněk Markdownu je také k dispozici možnost přidat buňku na řídicí panel. Další informace najdete v tématu Řídicí panely v poznámkových blocích.

Práce s buňkami v novém uživatelském rozhraní

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.

Databricks Assistant: Povolí nebo zakáže Databricks Assistant pro návrhy kódu v buňce.

Fokus buňky: Zvětšete buňku, aby bylo snazší ji upravovat.

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

Pokud chcete v novém uživatelském rozhraní spouštět buňky kódu, klikněte na šipku dolů v levém horním rohu buňky kódu.

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 dobu trvání spuštění. Další podrobnosti zobrazíte tak, že najedete myší na upozornění.

Pokud chcete přidat buňku Markdownu nebo buňku s tabulkovými výsledky na řídicí panel, vyberte v nabídce akcí buňky možnost Přidat na řídicí panel . Další informace najdete v tématu Řídicí panely v poznámkových blocích.

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

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.

Pokud chcete buňku přesunout nahoru nebo dolů, klikněte a podržte ji mimo levý horní roh buňky a přetáhněte ji na nové místo. V nabídce akcí buňky můžete také vybrat Přesunout nahoru nebo Přesunout dolů .

Vytvoření buněk

Poznámkové bloky mají dva typy buněk: kód a Markdown. 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:

Vytvoření buňky (původní uživatelské rozhraní)

Pokud chcete vytvořit novou buňku v původním uživatelském rozhraní, najeďte myší na buňku v horní nebo dolní části a klikněte na ikonu. Můžete také použít nabídku buněk poznámkového bloku: Klikněte a vyberte Přidat buňku nad nebo Přidat buňku pod.

Pro buňku s kódem stačí zadat kód do buňky. Pokud chcete vytvořit buňku Markdownu, vyberte Markdown z tlačítka jazyka buňky nebo napište %md v horní části buňky.

Vytvoření buňky (nové uživatelské rozhraní)

Pokud chcete vytvořit novou buňku v novém uživatelském rozhraní, 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 Markdownu.

Vyjmutí, kopírování a vložení buněk

Buňky můžete vyjmout a zkopírovat několika způsoby. Pokud používáte prohlížeč Safari, jsou dostupné jenom klávesové zkratky.

• V nabídce akcí buňky v původním uživatelském rozhraní nebo v novém uživatelském rozhraní vyberte Vyjmout buňku nebo Kopírovat buňku.
• Používejte klávesové zkratky: Command-X nebo Ctrl-X vyjmout nebo Command-CCtrl-C kopírovat.
• Použijte nabídku Upravit v horní části poznámkového bloku. Vyberte Vyjmout nebo zkopí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 na jinou kartu nebo okno prohlížeče. K vložení buněk použijte klávesovou zkratku Command-V nebo Ctrl-V. Buňky se vloží 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 možnosti nabídky Upravit > vyjmout buňky zpět nebo Upravit > zpět vložit buňky.

Pokud chcete 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. Pokud chcete vybrat všechny buňky, vyberte Upravit > vybrat všechny buňky nebo použijte zástupce příkazového režimu Cmd+A.

Obsah poznámkového bloku

Pokud chcete zobrazit automaticky vygenerovaný obsah, klikněte na ikonu v levém horním rohu poznámkového bloku (mezi levým bočním panelem a horní buňkou). Obsah se vygeneruje z nadpisů Markdownu použitých v poznámkovém bloku. Pokud používáte nové uživatelské rozhraní, zobrazí se v obsahu také buňky s názvy.

Možnosti zobrazení buňky

Poznámkové bloky mají tři možnosti zobrazení. Pomocí nabídky Zobrazení můžete změnit možnost zobrazení.

• Standardní zobrazení: Výsledky se zobrazí hned po buňkách kódu.
• Pouze výsledky: Zobrazí se pouze výsledky.
• Vedle sebe: vedle sebe se zobrazují buňky s kódem a výsledky.

V novém uživatelském rozhraní jsou akce dostupné z ikon v hřbetu buňky (oblast vpravo a vlevo od buňky). Chcete-li například přesunout buňku nahoru nebo dolů, použijte tečky úchytu v levém hřbetu. Pokud chcete odstranit buňku, použijte ikonu koše v pravém hřbetu.

Pokud chcete usnadnit úpravy, kliknutím na ikonu detailního režimu zobrazte buňku v plné šířce. Chcete-li ukončit detailní režim, klikněte na tlačítko . Zobrazenou šířku buňky můžete také zvětšit vypnutím rozložení Na střed zobrazení>.

Pokud chcete automaticky formátovat všechny buňky v poznámkovém bloku na standardní délky čar a mezery, vyberte Upravit > formát poznámkového bloku.

Řádková a příkazová čísla

Pokud chcete zobrazit nebo skrýt čísla řádků nebo čísla příkazů, vyberte čísla řádků nebo příkazová čísla z nabídky Zobrazit . Pro čísla řádků můžete také použít klávesovou zkratku Control+L.

Pokud povolíte řádek nebo čísla příkazů, Databricks uloží vaši předvolbu a zobrazí je ve všech ostatních poznámkových blocích pro daný prohlížeč.

Čísla řádků a příkazů (původní uživatelské rozhraní)

Čísla příkazů nad buňkami odkazují na tento konkrétní příkaz. Pokud kliknete na číslo příkazu pro buňku, aktualizuje se vaše adresa URL tak, aby byla ukotvena k danému příkazu. Pokud chcete získat odkaz na adresu URL konkrétního příkazu v poznámkovém bloku, klikněte pravým tlačítkem myši na číslo příkazu a zvolte Kopírovat adresu odkazu.

Řádek a čísla příkazů (nové uživatelské rozhraní)

Čísla řádků jsou ve výchozím nastavení v novém uživatelském rozhraní vypnutá. Pokud je chcete zapnout, vyberte Zobrazit > čísla řádků. Pokud je buňka v chybovém stavu, zobrazí se čísla řádků bez ohledu na výběr.

Pokud chcete přepnout čísla příkazů, vyberte Zobrazit > čísla příkazů.

Nové uživatelské rozhraní neobsahuje odkazy na číslo příkazu buňky. Pokud chcete získat odkaz na adresu URL na konkrétní příkaz v poznámkovém bloku, kliknutím otevřete detailní režim a zkopírujte adresu URL z adresního řádku prohlížeče. Chcete-li ukončit detailní režim, klikněte na tlačítko .

Přidání názvu buňky

Pokud chcete přidat název do buňky pomocí původního uživatelského rozhraní, vyberte v nabídce Akcí buňky možnost Zobrazit název.

Pokud chcete k buňce přidat název pomocí nového uživatelského rozhraní, udělejte jednu z těchto věcí:

• Klikněte na číslo buňky zobrazené uprostřed horní části buňky a zadejte název.
• V nabídce akcí buňky vyberte Přidat název.

V novém uživatelském rozhraní se buňky s názvy zobrazují v obsahu poznámkového bloku.

Zobrazení poznámkových bloků v tmavém režimu

Poznámkové bloky můžete zobrazit v tmavém režimu. Pokud chcete tmavý režim zapnout nebo vypnout, vyberte Zobrazit > motiv a vyberte Světlý motiv nebo Tmavý motiv.

Skrytí a zobrazení obsahu buňky

Obsah buňky se skládá z kódu buňky a výsledků vygenerovaných spuštěním buňky. Kód buňky a výsledek můžete skrýt a zobrazit pomocí nabídky akcí buňky v pravém horním rohu buňky.

Související funkce najdete v tématu Sbalitelné nadpisy.

Skrytí a zobrazení obsahu buňky (původní uživatelské rozhraní)

Chcete-li skrýt kód buňky nebo výsledky, klikněte a vyberte Skrýt kód nebo Skrýt výsledek. Můžete také vybrat , pokud chcete zobrazit jenom první řádek buňky.

Pokud chcete zobrazit skrytý kód buňky nebo výsledky, klikněte na zobrazit odkazy:

Skrytí a zobrazení obsahu buňky (nové uživatelské rozhraní)

Pokud chcete skrýt kód buňky nebo výsledky, klikněte na nabídku kebab v pravém horním rohu buňky a vyberte Skrýt kód nebo Skrýt výsledek. Pokud chcete zobrazit jenom první řádek buňky, můžete vybrat možnost Sbalit buňku . Pokud chcete rozbalit sbalenou buňku, vyberte Rozbalit buňku.

Pokud chcete zobrazit skrytý kód buňky nebo výsledky, klikněte na ikonu zobrazit: .

Sbalitelné nadpisy

Buňky, které se zobrazí po buňkách obsahujících nadpisy Markdownu, se dají sbalit do buňky nadpisu. Pokud chcete rozbalit nebo sbalit buňky po buňkách obsahujících nadpisy Markdownu v celém poznámkovém bloku, vyberte v nabídce Zobrazit sbalit všechna záhlaví. Zbytek této části popisuje, jak rozbalit nebo sbalit podmnožinu buněk.

Související funkce najdete v tématu Skrytí a zobrazení obsahu buňky.

Rozbalení a sbalení nadpisů (původní uživatelské rozhraní)

Obrázek znázorňuje nastavení MLflow se dvěma úrovněmi nadpisu s následujícími dvěma buňkami, které jsou do ní sbalené.

Chcete-li rozbalit a sbalit nadpisy, klikněte na tlačítko + a -.

Rozbalení a sbalení nadpisů (nové uživatelské rozhraní)

Obrázek znázorňuje nastavení MLflow se dvěma úrovněmi nadpisu s následujícími dvěma buňkami, které jsou do ní sbalené.

Pokud chcete rozbalit a sbalit nadpisy, najeďte kurzorem na buňku Markdownu. Klikněte na šipku, která se zobrazí vlevo od buňky.

Výpočetní prostředky pro poznámkové bloky

Tato část popisuje možnosti výpočetních prostředků poznámkového bloku. Poznámkový blok můžete spustit v clusteru Databricks nebo pro příkazy SQL máte také možnost použít SQL Warehouse, typ výpočetních prostředků, který je optimalizovaný pro analýzu SQL.

Připojení poznámkového bloku ke clusteru

Pokud chcete připojit poznámkový blok ke clusteru, potřebujete oprávnění PŘIPOJIT K úrovni clusteru.

Důležité

Pokud je poznámkový blok připojený ke clusteru, má každý uživatel s oprávněním CAN RUN v poznámkovém bloku implicitní oprávnění pro přístup ke clusteru.

Pokud chcete připojit poznámkový blok ke clusteru, klikněte na výběr výpočetních prostředků na panelu nástrojů poznámkového bloku a v rozevírací nabídce vyberte cluster.

V nabídce se zobrazí výběr clusterů, které jste nedávno použili nebo které jsou aktuálně spuštěné.

Pokud chcete vybrat ze všech dostupných clusterů, klikněte na Další.... Kliknutím na název clusteru zobrazte rozevírací nabídku a vyberte existující cluster.

Nový cluster můžete vytvořit také výběrem možnosti Vytvořit nový prostředek... z rozevírací nabídky.

Důležité

Připojený poznámkový blok má definované následující proměnné Apache Sparku.

Třída	Název proměnné
SparkContext	sc
SQLContext/HiveContext	sqlContext
SparkSession (Spark 2.x)	spark

Nevytvádřujte , SparkSessionSparkContextnebo SQLContext. To povede k nekonzistentnímu chování.

Použití poznámkového bloku se službou SQL Warehouse

Když je poznámkový blok připojený ke službě SQL Warehouse, můžete spouštět buňky SQL a Markdown. Pokud buňku spustíte v jiném jazyce (například Python nebo R), dojde k chybě. Buňky SQL spuštěné ve službě SQL Warehouse se zobrazují v historii dotazů SQL Warehouse. Uživatel, který spustil dotaz, může zobrazit profil dotazu z poznámkového bloku kliknutím na uplynulý čas v dolní části výstupu.

Spuštění poznámkového bloku vyžaduje pro nebo bezserverový SQL Warehouse. Musíte mít přístup k pracovnímu prostoru a SQL Warehouse.

Pokud chcete k SQL Warehouse připojit poznámkový blok, postupujte takto:

1. Na panelu nástrojů poznámkového bloku klikněte na selektor výpočetních prostředků. V rozevírací nabídce se zobrazují výpočetní prostředky, které jsou aktuálně spuštěné nebo které jste nedávno použili. Sklady SQL jsou označené značkou .

2. V nabídce vyberte SQL Warehouse.

   Pokud chcete zobrazit všechny dostupné sklady SQL, v rozevírací nabídce vyberte Další... Zobrazí se dialogové okno s výpočetními prostředky dostupnými pro poznámkový blok. Vyberte SQL Warehouse, zvolte sklad, který chcete použít, a klikněte na Připojit.

   

Při vytváření pracovního postupu nebo naplánované úlohy můžete také jako výpočetní prostředek pro poznámkový blok SQL vybrat SQL Warehouse.

Mezi omezení sql warehouse patří:

• Při připojení ke skladu SQL mají kontexty spouštění časový limit nečinnosti 8 hodin.
• Maximální velikost vrácených výsledků je 10 000 řádků nebo 2 MB podle toho, co je menší.

Odpojení poznámkového bloku

Pokud chcete odpojit poznámkový blok od výpočetního prostředku, klikněte na výběr výpočetních prostředků na panelu nástrojů poznámkového bloku a najeďte myší na připojený cluster nebo SQL Warehouse v seznamu, aby se zobrazila boční nabídka. V boční nabídce vyberte Odpojit.

Poznámkové bloky můžete také odpojit od clusteru pomocí karty Poznámkové bloky na stránce podrobností clusteru.

Když poznámkový blok odpojíte, kontext spuštění se odebere a všechny vypočítané hodnoty proměnných se z poznámkového bloku vymažou.

Tip

Azure Databricks doporučuje odpojit nepoužívané poznámkové bloky z clusterů. Tím se uvolní místo v paměti ovladače.

Použití webového terminálu a rozhraní příkazového řádku Databricks

Pokud chcete otevřít webový terminál v poznámkovém bloku, klikněte v dolní části pravého bočního panelu.

Použití Rozhraní příkazového řádku Databricks ve webovém terminálu

Od Databricks Runtime 15.0 můžete použít Rozhraní příkazového řádku Databricks z webového terminálu v poznámkovém bloku.

Požadavky

• Poznámkový blok musí být připojený ke clusteru v režimu sdíleného přístupu s jedním uživatelem nebo bez izolace.
• Rozhraní příkazového řádku není dostupné v pracovních prostorech povolených pro Službu Private Link.

Nainstalované rozhraní příkazového řádku je vždy nejnovější verzí. Ověřování je založeno na aktuálním uživateli.

Rozhraní příkazového řádku nemůžete použít z buňky poznámkového bloku. Příkazy jako %sh databricks ... v poznámkovém bloku nefungují s Modulem Databricks Runtime 15.0 nebo novějším.