Sdílet prostřednictvím


Použití interaktivního ladicího programu Databricks

Důležité

Tato funkce je ve verzi Public Preview.

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

Interaktivní ladicí program poskytuje zarážky, podrobné provádění, kontrolu proměnných a další nástroje, které vám pomůžou efektivněji vyvíjet kód v poznámkových blocích.

Požadavky

Poznámkový blok musí být připojený ke clusteru, který splňuje následující požadavky:

  • Databricks Runtime verze 13.3 LTS nebo vyšší
  • Režim přístupu musí být jeden uživatel (přiřazený) nebo bez sdílené izolace.

Povolení nebo zakázání ladicího programu

Pokud chcete povolit nebo zakázat ladicí program, postupujte takto:

  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 bočním panelu Nastavení vyberte Vývojář.
  3. V části Experimentální funkce přepněte interaktivní ladicí program poznámkového bloku Pythonu.

Spuštění ladicího programu

Ladicí program spustíte takto:

  1. Kliknutím do hřbetu buňky přidejte jednu nebo více zarážek. Pokud chcete zarážku odebrat, klikněte na ni znovu.

    vytvoření a odebrání videa o zarážkách

  2. Proveďte některou z následujících akcí:

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

    ladění položky buňky v nabídce spuštění buňky

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

Ladicí program můžete spustit také v případě, že buňka aktivuje chybu. V dolní části výstupu buňky klikněte na Tlačítko Ladění.

Když je aktivní ladicí relace, zobrazí se panel nástrojů Panel nástrojů Ladění ladění v horní části buňky.

Použití ladicího programu

anotovaný panel nástrojů ladicího programu

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

  • Nastavte nebo odeberte zarážky.
  • Umožňuje zobrazit hodnoty proměnných na zarážce.
  • Projděte si kód.
  • Vstupte do funkce nebo 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].

Použití konzoly ladění

Když spustíte ladicí relaci, konzola ladění se automaticky zobrazí v dolním panelu. Tato konzola umožňuje spustit kód Pythonu pro kontrolu proměnných nebo manipulaci s nimi při pozastavení na zarážce. 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.

debug_console

Poznámka:

  • Konzola ladění je navržená pro rychlé vyhodnocení a vyprší časový limit, pokud provádění kódu překročí 15 sekund.
  • Příkaz display není v konzole 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.

Použití Průzkumníka proměnných

K zobrazení hodnot proměnných proměnných můžete použít panel Průzkumník 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é.

debug_variable_explorer

Ukončení relace ladicího programu

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

Omezení

Další informace najdete v poznámkových blocích Databricks se známými omezeními .