Navigace v poznámkovém bloku Databricks a editoru souborů

Tento článek popisuje funkce, které vám pomůžou procházet poznámkový blok a editor souborů Databricks, včetně klávesových zkratek, návrhů kódu a automatického dokončování, kontroly proměnných a posouvání kódu. Když používáte poznámkový blok nebo editor souborů, je nástroj Databricks Assistant k dispozici, který vám pomůže vygenerovat, vysvětlit a ladit kód. Podrobnosti najdete v tématu Získání nápovědy ke kódování od Databricks Assistantu.

Můžete si vybrat z výběru motivů editoru. Vyberte Zobrazit > Motiv Editoru a udělejte výběr z nabídky.

paleta příkazů

Akce v poznámkovém bloku můžete rychle provádět pomocí palety příkazů. Pokud chcete otevřít panel akcí poznámkového bloku, klikněte na V pravém dolním rohu pracovního prostoru nebo použijte klávesovou zkratku Cmd + Shift + P v macOS nebo Ctrl + Shift + P ve Windows.

Minimapa spuštění buněk

Pokud chcete získat vizuální přehled o stavu provádění poznámkového bloku, použijte minimapu provádění buněk. Minimapa se zobrazí na pravém okraji a zobrazí stavový řádek pro každou spustitelné buňku.

Stavové pruhy označují následující stavy spuštění:

• Světle šedá: Buňka je statická.
• Tmavě šedá: Buňka se buď přeskočí, nebo se zařadí do fronty pro spuštění.
• Světle šedá s pohyblivým pruhem: Buňka je aktuálně spuštěná.
• Zelená: Buňka se úspěšně spustila bez chyb.
• Červená: Buňka selhala s chybou.

Interakce s minimapou:

• Když najedete myší na minimapu, zobrazí se seznam spustitelných buněk, jejich názvů a stavů spuštění.
• Kliknutím na položku přejdete přímo na danou buňku v poznámkovém bloku.
• Kliknutím na Přejít na poslední buňku spuštění nebo Přejít na první buňku, která se nezdařila , přejděte na poslední nebo první neúspěšnou buňku.

Minimapa vám pomůže sledovat průběh provádění na první pohled a rychle procházet při ladění nebo vývoji.

Vyhledání a nahrazení textu

Pokud chcete najít a nahradit text v poznámkovém bloku, použijte klávesovou zkratku ( Cmd + F Mac) nebo (Windows) nebo Ctrl + Fklikněte na Upravit > najít... a otevřete dialogové okno Najít . Zadejte text, který chcete najít. Aktuální shoda je zvýrazněná oranžově a všechny ostatní shody jsou zvýrazněné žlutě. Pokud chcete získat přístup k nativnímu vyhledávání v prohlížeči, stiskněte Cmd + F (Mac) nebo Ctrl + F(Windows) znovu.

Klikněte na Tím otevřete možnost Nahradit. Zadejte text, který chcete použít. Chcete-li nahradit aktuální shodu, klikněte na tlačítko Nahradit. Chcete-li nahradit všechny shody v poznámkovém bloku, kliknutím zvolte Nahradit vše.

Mezi shodami se můžete pohybovat kliknutím na (předchozí shoda) nebo (další shoda). Můžete také stisknout Shift + Enter a Enter přejít na předchozí a další zápasy.

Nástroj Najít a nahradit zavřete kliknutím na nebo stisknutím klávesy Esc.

Kontrola proměnných

Pokud chcete zobrazit informace o proměnné definované v poznámkovém bloku SQL nebo Pythonu, najeďte kurzorem na název proměnné. Kontrola proměnných Pythonu vyžaduje Databricks Runtime 12.2 LTS nebo vyšší.

Viz Průzkumník proměnných.

Přejít k definici

Když je poznámkový blok Pythonu připojený k výpočetnímu prostředku, můžete rychle přejít k definici proměnné, funkce nebo kódu za příkazem %run . Chcete-li to provést, pravým tlačítkem myši klikněte na název proměnné nebo funkce a potom zvolte Přejít k definici nebo Náhled definice.

Podržte stisknutou klávesu Cmd v systému macOS nebo Ctrl ve Windows a najeďte myší na název proměnné nebo funkce. Pokud se definice najde, název se změní na hypertextový odkaz.

Funkce Přejít k definici je dostupná v Databricks Runtime 12.2 LTS a vyšší.

Skládání kódu

Posouvání kódu umožňuje dočasně skrýt části kódu. To může být užitečné při práci s dlouhými bloky kódu, protože umožňuje zaměřit se na konkrétní části kódu, na které pracujete.

Pokud chcete kód skrýt, umístěte kurzor úplně vlevo od buňky. Šipky směřující dolů se zobrazují v logických bodech, kde můžete skrýt část kódu. Kliknutím na šipku skryjete oddíl kódu. Znovu klikněte na šipku (teď ukazující na pravé straně) a zobrazte kód.

Další podrobnosti, včetně klávesových zkratek, najdete v dokumentaci ke VS Code.

Podpora multikurzoru

Můžete vytvořit více kurzorů, abyste usnadnili souběžné úpravy, jak je znázorněno ve videu:

Vytvoření více kurzorů v buňce:

• V systému macOS podržte stisknutou klávesu Option a kliknutím na každé místo přidejte kurzor.
• Ve Windows podržte klávesu Alt a kliknutím na každé místo přidejte kurzor.
• Můžete také změnit klávesovou zkratku. Podívejte se na Změnit zástupce pro multikurzor a výběr sloupců.

V systému macOS můžete vytvořit více svisle zarovnaných kurzorů pomocí klávesové zkratky Option+Command+ šipka nahoru nebo dolů.

Výběr sloupce (pole)

Pokud chcete vybrat více položek ve sloupci, klikněte v levém horním rohu oblasti, kterou chcete zachytit. Then:

• V systému macOS stiskněte Shift + Option a tažením doprava dolů zachyťte jeden nebo více sloupců.
• Ve Windows stiskněte Shift + Alt a tažením doprava dolů zachyťte jeden nebo více sloupců.
• Můžete také změnit klávesovou zkratku. Podívejte se na Změnit zástupce pro multikurzor a výběr sloupců.

Změnit zástupce pro vícenásobný kurzor a výběr sloupců

Pro výběr vícekurzorový a sloupce (box) je k dispozici alternativní klávesová zkratka. Při alternativním výběru se klávesové zkratky mění takto:

• Vytvoření více kurzorů v buňce:
  • V systému macOS podržte stisknutou klávesu Cmd a kliknutím na každé místo přidejte kurzor.
  • Ve Windows podržte klávesu Ctrl a kliknutím na každé místo přidejte kurzor.
• Pokud chcete vybrat více položek ve sloupci, klikněte v levém horním rohu oblasti, kterou chcete zachytit. Then:
  • V systému macOS stiskněte Option a tažením doprava dolů zachyťte jeden nebo více sloupců.
  • Ve Windows stiskněte Alt a tažením doprava dolů zachyťte jeden nebo více sloupců.

Pokud chcete povolit alternativní klávesové zkratky, postupujte takto:

1. Klikněte na své uživatelské jméno v pravém horním rohu pracovního prostoru a potom v rozevíracím seznamu klikněte na Nastavení.
2. Na bočním panelu Nastavení vyberte Vývojář.
3. V části Editor kódu změňte modifikátor klávesy pro nastavení kliknutí na více kurzorů na Cmd pro macOS nebo Ctrl pro Windows.

Když povolíte alternativní klávesové zkratky, klávesová zkratka pro vytvoření více svisle zarovnaných kurzorů se nezmění.

Procházet data

Pomocí prohlížeče schémat můžete prozkoumat objekty katalogu Unity dostupné pro poznámkový blok. Klikněte na Na levé straně poznámkového bloku otevřete prohlížeč schématu.

Tlačítko Pro vás zobrazí jenom ty objekty, které jste použili v aktuální relaci nebo které jste dříve označili jako oblíbené.

Při psaní textu do pole Filtr se zobrazení změní tak, aby zobrazoval jenom objekty, které obsahují zadaný text. Zobrazí se pouze objekty, které jsou aktuálně otevřené nebo byly otevřeny v aktuální relaci. Pole Filtr neprovádí úplné vyhledávání katalogů, schémat, tabulek a svazků dostupných pro poznámkový blok.

Ikonu , že najedete myší na název objektu, jak je znázorněno:

nabídka kebabu

Pokud je objekt tabulkou, můžete udělat toto:

• Automaticky vytvořte a spusťte buňku, aby se zobrazil náhled dat v tabulce. Vyberte Náhled v nové buňce z nabídky kebab tabulky.
• Zobrazení katalogu, schématu nebo tabulky v Průzkumníku katalogu V nabídce kebab vyberte Otevřít v Průzkumníku katalogu. Otevře se nová karta s vybraným objektem.
• Získejte cestu k katalogu, schématu nebo tabulce. Vyberte Kopírovat… cestu z kontextové nabídky objektu.
• Přidejte tabulku k oblíbeným položkám. V nabídce kebab pro tabulku vyberte Přidat k oblíbeným.

Pokud je objekt katalogem, schématem nebo svazkem, můžete zkopírovat cestu k objektu nebo ho otevřít v Průzkumníku katalogu.

Vložení názvu tabulky nebo sloupce přímo do buňky:

1. Klikněte na kurzor v buňce v místě, kde chcete zadat název.
2. Přesuňte kurzor na název tabulky nebo název sloupce v prohlížeči schématu.
3. Klikněte na dvojitou šipku , která se zobrazí napravo od názvu objektu.

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 na V dolní části pravého bočního panelu.

Ve verzi Databricks Runtime 15.0 nebo vyšší můžete použít Databricks CLI z webového terminálu přímo v notebooku. Informace o požadavcích a použití najdete v tématu Spouštění příkazů prostředí ve webovém terminálu Azure Databricks.

Rozhraní příkazového řádku nemůžete použít v buňce 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.

Personalizované automatické dokončování

Automatické dokončování automaticky dokončí segmenty kódu při jejich psaní. Mezi kompletovatelné objekty patří typy, třídy a objekty, stejně jako databáze SQL, názvy tabulek, struktury, mapy, pole a fragmenty dotazů. Při odkazování na běžné výrazy tabulky (CTE), které používají SELECT *, poskytuje automatické dokončování doporučení sloupců na základě základní struktury tabulky. Databricks používá metadata a používání Unity Catalogu k personalizaci návrhů.

• V případě buněk Pythonu musí být poznámkový blok připojený k výpočetnímu prostředku , aby automatické dokončování fungovalo, a musíte spustit všechny buňky , které definují kompletovatelné objekty.
• U buněk SQL navrhuje automatické dokončování klíčová slova a základní syntaxi i v případě, že poznámkový blok není připojený k žádnému výpočetnímu prostředku.
  • Pokud je pracovní prostor povolen pro Unity katalog, automatické dokončování navrhne také názvy katalogů, schémat, tabulek a sloupců pro tabulky v Unity katalogu.
  • Pokud není pro katalog Unity povolený pracovní prostor, musí být poznámkový blok připojený k víceúčelovému výpočetnímu prostředku nebo k SQL Warehouse, aby mohl navrhovat názvy tabulek nebo sloupců.

Návrhy automatického dokončování se automaticky zobrazí při psaní do buňky. Pomocí kláves se šipkou nahoru a dolů nebo myší vyberte návrh a stisknutím klávesy Tab nebo Enter vložte výběr do buňky.

Note

Automatické doplňování ze serveru v poznámkových blocích jazyka R je během provádění příkazů blokováno.

Automatické dokončování je ve výchozím nastavení povolené, ale můžete ho zakázat v uživatelských nastaveních:

• Pokud chcete vypnout návrhy automatického dokončování, přepněte automatické dokončování při psaní. Když je automatické dokončování vypnuté, můžete zobrazit návrhy automatického dokončování stisknutím kombinace kláves Ctrl + mezerník.
• Pokud nechcete, aby Enter vkládaly návrhy automatického dokončování, přepněte klávesu Enter, která přijímá návrhy automatického dokončování.

Párování závorek

Když kliknete na závorku, hranatou závorku nebo složenou závorku, editor zvýrazní tento znak a odpovídající závorku.

Zvýraznění chyb Pythonu

Pracovní prostory s povolenými funkcemi umělé inteligence partnerem podporovanými můžou také vybrat Opravit s pomocníkem pro návrhy s asistencí umělé inteligence.

Poznámkové bloky Databricks podporují zvýraznění následujících chyb:

• Zvýraznění chyby syntaxe Pythonu: Všechny chyby syntaxe v buňkách kódu Pythonu jsou zvýrazněné červeně. Pokud je to možné, pomocník vám navrhne rychlou opravu. To se podporuje pro výpočetní prostředky, na kterých běží Databricks Runtime 12.1 a vyšší nebo bezserverové výpočetní prostředky. Konfiguraci zvýrazňování chyb syntaxe můžete nastavit pomocí souborů pyproject.toml. Viz Konfigurace zvýraznění syntaxe Pythonu.
• Zvýraznění chyby formátu Pythonu: Chyby formátování kódu Pythonu a upozornění jsou v závislosti na závažnosti podtržené žlutou nebo červenou barvou. To může pomoct s identifikací problémů s formátováním, jako je neočekávané odsazení, dlouhá délka čáry a další. Když najedete myší na upozornění syntaxe, zobrazí se další informace. To se podporuje pro výpočetní prostředky, na kterých běží Databricks Runtime 12.1 a vyšší nebo bezserverové výpočetní prostředky.
• Zvýraznění chyby typu Python: Kontrola typů může zlepšit kvalitu kódu, čitelnost a udržovatelnost v projektech Python a PySpark. Kontroly typů můžou označit chyby související s neexistující atributy, chybějícími argumenty a neshodnými argumenty ve voláních funkce před spuštěním kódu. Když najedete myší na zvýrazněná upozornění, zobrazí se další informace. To je podporované pro výpočty, na kterých běží Databricks Runtime 16.0 nebo novější nebo bezserverové prostředí 2.

Povolení zvýraznění chyb Pythonu

Pokud chcete povolit nebo zakázat zvýraznění chyb, postupujte takto:

1. Klikněte na své uživatelské jméno v pravém horním rohu pracovního prostoru a potom v rozevíracím seznamu klikněte na Nastavení.
2. Na bočním panelu Nastavení vyberte Vývojář.
3. Přepněte nastavení zvýraznění chyby syntaxe Pythonu (v editoru kódu), zvýraznění chyb ve formátu Pythonu (v části Experimentální funkce) nebo zvýraznění chyb typu Python (v části Experimentální funkce).

Konfigurace zvýraznění syntaxe Pythonu

Pokud je poznámkový blok připojený k výpočetnímu prostředí Databricks Runtime verze 16.4 nebo vyšší nebo k bezserverovému prostředí verze 3 nebo vyšší, můžete přizpůsobit chování zvýraznění syntaxe vytvořením pyproject.toml souboru. Pro daný poznámkový blok se použije nejbližší pyproject.toml soubor v jeho přímé nadřazené cestě v systému souborů pracovního prostoru. Pokud nelze najít soubor v nadřazené cestě, pak se použije pyproject.toml soubor v domovské složce aktuálního uživatele.

Například, pokud máte poznámkový blok s cestou a/b/c/d/notebook.py a jsou k dispozici soubory na pyproject.toml a a/b/pyproject.toml, pak budou použity soubory z a/b/pyproject.toml, protože jsou blíž. Soubor pyproject.toml na /a/b/c/e/pyproject.toml adrese by nebyl považován za soubor, protože není v přímé nadřazené cestě.

Azure Databricks používá pro pyproject.toml soubory standardní syntaxi. Můžete se například podívat na dokumentaci k Ruffu a podívat se, jak nakonfigurovat linter Ruff se souborem pyproject.toml .

Azure Databricks v současné době podporuje pouze konfiguraci ruff, pylint, pyright a flake8 pro lintování prostřednictvím pyproject.toml.

Aby byl linter povolen, musí mít soubor pyproject.toml blok [tool.<name-of-linter>].

Pokud chcete explicitně zakázat linter, přidejte následující blok:

[tool.<name-of-linter>]
disabled=true

Pravidla zvýrazňování syntaxe napsaná v Azure Databricks můžete také zakázat pomocí bloku, například:

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Protože Flake8 očekává konfiguraci v jiném formátu, musíte předat konfiguraci pro Flake8 jako řetězec:

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

Přizpůsobení formátování SQL

Nastavení formátování SQL můžete přizpůsobit v novém editoru SQL a v editoru poznámkových bloků. Klikněte na Zobrazit > nastavení pro vývojáře. Posuňte se dolů do formátu SQL a zadejte nastavení.

Použití klávesových zkratek

Pokud chcete zobrazit klávesové zkratky, vyberte Nápovědu > Klávesové zkratky. Dostupné klávesové zkratky závisí na tom, jestli je kurzor v buňce kódu (režim úprav) nebo ne (režim příkazů).

V následujících tabulkách jsou uvedeny dostupné klávesové zkratky.

Klávesové zkratky režimu úprav

Funkce	Zástupce macOS	Zástupce systému Windows
Přepnout do režimu příkazů	Esc	Esc
Spuštění příkazu a vložení nové buňky pod	Option + Enter	Alt + Enter
Vložení buňky nad	Ctrl + Option + P	Ctrl + Alt + P
Vložení buňky pod	Ctrl + Option + N	Ctrl + Alt + N
Přechod na předchozí nebo další buňku	Option + Up/Down	Alt + Up/Down
Rozdělení buňky na kurzor	Ctrl + Option + -	Ctrl + Alt + -
Odstranit aktuální řádek	⌘ + Shift + K	Ctrl + Shift + K
Odstranit aktuální buňku	Ctrl + Option + D	Ctrl + Alt + D
Přesunutí nahoru nebo na předchozí buňku	Up	Up
Přesunutí dolů nebo na další buňku	Down	Down
Automatické dokončování	Ctrl + Space	Ctrl + Space
Automatické dokončování pomocníka	Ctrl + Shift + Space	Ctrl + Shift + Space
Vložený asistent	⌘ + I	Ctrl + I
Nápovědy k parametrům	⌘ + Shift + Space	Ctrl + Shift + Space
Docstring	⌘ + (K, I)	Ctrl + (K, I)
Více kurzorů	Option + Click	Alt + Click
Výběr sloupce (pole)	Option + Shift + Drag	Alt + Shift + Drag
Výběr odsazení nebo unindentu	⌘ + ]/[	Ctrl + ]/[
Vrácení psaní zpět	⌘ + Z	Ctrl + Z
Opětovné psaní	⌘ + Shift + Z	Ctrl + Shift + Z
Přepnout komentář řádku	⌘ + /	Ctrl + /
Přidat komentář řádku	⌘ + (K, C)	Ctrl + (K, C)
Odebrat komentář řádku	⌘ + (K, U)	Ctrl + (K, U)
Úpravy více kurzorů	⌘ + Option + Up/Down	Ctrl + Option + Up/Down
Zvětšení velikosti písma	Option + +	Alt + +
Zmenšení velikosti písma	Option + -	Alt + -

Klávesové zkratky režimu příkazů

Funkce	Zástupce mac OS	Zástupce systému Windows
Přepnout do režimu úprav	Enter	Enter
Zrušit provádění vybraných buněk	I, I	I, I
Zrušit provádění (přeskočit výzvu)	Shift + (I, I)	Shift + (I, I)
Odstranit aktuální buňku	D, D	D, D
Odstranit aktuální buňku (přeskočit výzvu)	Shift + (D, D)	Shift + (D, D)
Přejít na první buňku	G, G	G, G
Přejít na poslední buňku	Shift + G	Shift + G
Vrácení vyjmutí nebo odstranění buněk	⌘ + Z/Z	Ctrl + Z/Z
Kopírovat aktuální buňku	⌘ + C	Ctrl + C
Vyjmutí aktuální buňky	⌘ + X	Ctrl + X
Vložit buňku	⌘ + V	Ctrl + V
Vložení buňky nad	A	A
Vložení buňky pod	B	B
Přepnout výstup buňky	O	O
Přepnout název buňky	T	T
Posuňte se dolů	Space	Space
Posuňte nahoru	Shift + Space	Shift + Space
Přepnout nabídku klávesových zkratek	H	H
Sloučit s buňkou níže	Shift + M	Shift + M
Přechod na předchozí buňku	Up/P/K	Up/P/K
Přesunout na další buňku	Down/N/J	Down/N/J
Přidání sousední buňky k výběru	Shift + Up/Down	Shift + Up/Down
Vybrat všechny buňky	⌘ + A	Ctrl + A
Výběr více buněk	⌘ + Click	Ctrl + Click
Přepnout čísla řádků	L	L
Rozbalení nebo sbalení záhlaví buněk	Right/Left	Right/Left

Sdílené klávesové zkratky

Funkce	Zástupce macOS	Zástupce systému Windows
Přepnout paletu příkazů	⌘ + Shift + P	Ctrl + Shift + P
Najít	⌘ + F	Ctrl + F
Nahradit	Ctrl + Option + F	Ctrl + Alt + F
Formátování kódu	⌘ + Shift + F	Ctrl + Shift + F
Spuštění příkazu a přechod na další buňku	Shift + Enter	Shift + Enter
Spuštění vybraných příkazů	⌘ + Enter	Ctrl + Enter
Ladicí buňka	Option + Shift + D	Alt + Shift + D
Ladicí program: Pokračovat	F7	F7
Ladicí program: Další řádek	F8	F8
Ladicí program: Krok do	F9	F9
Ladicí program: Krok ven	Shift + F9	Shift + F9
Spuštění všech příkazů	Option + Shift + Enter	Alt + Shift + Enter
Spuštění všech výše uvedených příkazů (výhradní)	Option + Shift + Up	Alt + Shift + Up
Spuštění všech následujících příkazů (včetně)	Option + Shift + Down	Alt + Shift + Down
Vymazat stav a výstupy	0, 0	0, 0
Spuštění vybraného textu nebo aktivního příkazu	Ctrl + Shift + Enter	Ctrl + Shift + Enter
Spuštění aktivního příkazu SQL	⌘ + Shift + Enter	Ctrl + Shift + Enter
Přesunutí buňky nahoru	Ctrl + Option + Up	Ctrl + Alt + Up
Přesunutí buňky dolů	Ctrl + Option + Down	Ctrl + Alt + Down
Přepnutí panelu komentářů / přidání komentáře	Ctrl + Option + M	Ctrl + Alt + M
Přepnout panel pracovního prostoru	Ctrl + Option + E	Ctrl + Alt + E
Přepnout panel katalogu	Ctrl + Option + C	Ctrl + Alt + C
Přepínací panel pomocníka	Ctrl + Option + A	Ctrl + Alt + A
Přepnout detailní režim	Ctrl + Option + O	Ctrl + Alt + O
Zavřít aktuální kartu	Ctrl + Option + W	Ctrl + Alt + W
Vytvořit novou kartu	Ctrl + Option + T	Ctrl + Alt + T
Přepnutí na levou kartu	Ctrl + Option + Left	Ctrl + Alt + Left
Přepnout na pravou kartu	Ctrl + Option + Right	Ctrl + Alt + Right
Zavření všech karet	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A