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.

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

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.