Ladění notebooků

Tato stránka popisuje, jak používat integrovaný interaktivní ladicí nástroj v poznámkovém bloku Databricks. Debugger je k dispozici pouze pro Python.

Interaktivní ladicí program poskytuje body přerušení, postupné provádění, kontrolu proměnných a další nástroje, které vám pomohou účinněji psát kód v poznámkových blocích.

Požadavky

Pokud chcete získat přístup k ladicímu programu, musí být poznámkový blok připojený k některému z následujících výpočetních prostředků:

• Bezserverové výpočetní prostředí
• Výpočty s režimem přístupu nastaveným na Standard (dříve sdílené) v Databricks Runtime 14.3 LTS a vyšší
• Výpočty s režimem přístupu nastavené na Dedicated (dříve jeden uživatel) v Databricks Runtime 13.3 LTS a vyšší
• Výpočty s režimem přístupu nastavenou na Sdílené bez izolace v Databricks Runtime 13.3 LTS a vyšší

Povolte ladicí program

Pro aktivaci ladicího programu postupujte podle těchto kroků:

1. Klikněte na své uživatelské jméno v pravém horním rohu pracovního prostoru a v rozevíracím seznamu vyberte Nastavení.
2. Na panelu Nastavení na boční straně vyberte Vývojář.
3. V části Nastavení editoru přepněte interaktivní ladicí program poznámkového bloku Pythonu.

Začít ladění

Spusťte ladicí program takto:

1. Kliknutím do okraje buňky přidejte jeden nebo více zarážek. Chcete-li odstranit bod přerušení, klikněte na něj znovu.

   

2. Spusťte ladicí relaci pomocí jedné z následujících možností:

   • Klikněte na Spustit > buňku Ladit.
   • Použijte klávesovou zkratku Option + Shift + D.
   • V nabídce spuštění buňky vyberte Ladit buňku.

   

Ladicí relace se spustí automaticky a spustí vybranou buňku.

Ladicí program můžete spustit také, pokud buňka vyvolá chybu. V dolní části výstupu buňky klikněte na .

Když je aktivní ladicí relace, zobrazí se v horní části buňky.

Akce ladění

V ladicí relaci můžete provést následující akce:

• Nastavit nebo odstranit zarážky.
• Zobrazit hodnoty proměnných na přerušení.
• Projděte si kód.
• Vstupte do funkce nebo vystupte z funkce.
• Najděte řádek kódu, kde se ladicí program zastavil.

Když kód dosáhne zarážky, zastaví se před spuštěním řádku, nikoli po.

Pomocí tlačítek na panelu nástrojů ladicího programu můžete procházet kód. Při procházení kódu se aktuální řádek v buňce zvýrazní. Hodnoty proměnných můžete zobrazit v podokně Průzkumník proměnných na pravém bočním panelu.

Při procházení funkce se místní proměnné funkce zobrazí v podokně proměnných označeném [local].

Vstup do souborů pracovního prostoru

Když povolíte karty pro poznámkové bloky a soubory, můžete nastavit zarážky a přejdete do funkcí definovaných v jiných souborech pracovního prostoru. Chcete-li vstoupit do funkce, klikněte na ikonu . Pokud je funkce definovaná v jiném souboru v rámci pracovního prostoru, ladicí program tento soubor otevře na nové kartě.

Poznámka:

• Ladicí program může přejít pouze do funkcí definovaných v souborech v pracovním prostoru. Vstupování do knihoven Pythonu nebo jiných poznámkových bloků se zatím nepodporuje.
• Pokud po importu upravíte externí soubory, relace poznámkového bloku může stále používat starou verzi modulu. Pokud chcete zajistit, aby se úpravy importovaných modulů projevily během ladění, použijte automatické načítání pro moduly Pythonu v Databricks Runtime 18.0 nebo bezserverové výpočetní prostředí verze 4 nebo novější.

Konzole pro ladění

Když spustíte ladicí relaci, konzole ladění se automaticky zobrazí v dolním panelu. Tato konzola umožňuje spustit kód Pythonu pro prověření nebo manipulaci proměnných při pozastavení v bodu přerušení. Kód spuštěný v hlavním poznámkovém bloku se nespustí během ladicí relace. Pokud chcete spustit kód v konzole, stiskněte Enter. U výrazů s více řádky se pomocí kombinace kláves Shift + Enter přesuňte na nový řádek.

Poznámka:

• Konzole ladění je navržena pro rychlé vyhodnocování a přestane fungovat, pokud běh kódu trvá déle než 15 sekund.
• Příkaz display není v konzole pro ladění podporován. Pokud chcete zobrazit ukázková data z datového rámce, použijte df.show() pro datové rámce PySpark nebo df.head() pro datové rámce Pandas.

Průzkumník proměnných

K zobrazení hodnot proměnných můžete použít panel Průzkumníka proměnných na pravé straně. Kliknutím na Tlačítko Zkontrolovat automaticky spustíte kód v konzole ladění, aby se vypíše hodnota proměnné.

Pokud chcete zobrazení filtrovat, zadejte do vyhledávacího pole text. Při psaní se seznam automaticky vyfiltruje.

Pro Python v Databricks Runtime 12.2 LTS a novější se proměnné aktualizují během spuštění buňky. V případě Scala, R a Pythonu v Databricks Runtime 11.3 LTS a níže se proměnné aktualizují po dokončení spuštění buňky.

Ukončení relace ladicího programu

Pokud chcete ukončit ladicí relaci, klikněte v levém horním rohu buňky nebo klikněte v horní části poznámkového bloku. Ladicí relace se také automaticky ukončí po 30 minutách, pokud uživatel nepoužívá ladicí panel nebo ladicí konzoli.

Ladění pomocí Databricks Assistant

Databricks Assistant je pomocník s AI pracující s kontextem, který vám může pomoct s laděním kódu. Další informace o příkazových zkratkách Assistant pro poznámkové bloky najdete zde.

Omezení

Další informace najdete v poznámkách k známým omezením Databricks.