Dela via

Felsöka notebook-filer

  • Artikel

Viktigt!

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Den här sidan beskriver hur du använder det inbyggda interaktiva felsökningsprogrammet i Databricks Notebook. Felsökningsprogrammet är endast tillgängligt för Python.

Det interaktiva felsökningsprogrammet innehåller brytpunkter, stegvis körning, variabel inspektion och fler verktyg som hjälper dig att utveckla kod i notebook-filer mer effektivt.

Krav

Anteckningsboken måste vara ansluten till ett kluster som uppfyller följande krav:

  • Databricks Runtime version 13.3 LTS eller senare.
  • Åtkomstläget måste vara Enskild användare (Tilldelad) eller Ingen isolering delas.

Aktivera felsökningsprogrammet

Använd följande steg för att aktivera felsökningsprogrammet:

  1. Klicka på ditt användarnamn längst upp till höger på arbetsytan och välj Inställningar i listrutan.
  2. I sidofältet Inställningar väljer du Utvecklare.
  3. I avsnittet Experimentella funktioner växlar du python Notebook Interactive Debugger.

Börja felsöka

Starta felsökningsprogrammet genom att följa dessa steg:

  1. Lägg till en eller flera brytpunkter genom att klicka i rännstenen i en cell. Om du vill ta bort en brytpunkt klickar du på den igen.

    video om att skapa och ta bort brytpunkter

  2. Starta felsökningssessionen med något av följande alternativ:

    • Klicka på Kör felsökningscell>.
    • Använd kortkommandoalternativet + Skift + D.
    • Välj Felsök cell på menyn för cellkörning.

    felsöka cellobjekt i cellkörningsmenyn

En felsökningssession startar automatiskt och kör den valda cellen.

Du kan också starta felsökningsprogrammet om en cell utlöser ett fel. Klicka på Knappen Felsökalängst ned i cellutdata.

När en felsökningssession är aktiv visas verktygsfältet Felsökningsverktygsfältet för felsökning överst i cellen.

Felsökningsåtgärder

verktygsfält för kommenterat felsökningsprogram

I en felsökningssession kan du göra följande:

  • Ange eller ta bort brytpunkter.
  • Visa värdena för variabler vid en brytpunkt.
  • Stega igenom koden.
  • Gå in i eller ut ur en funktion.

När koden når en brytpunkt stoppas den innan raden körs, inte efter.

Använd knapparna i verktygsfältet för felsökningsprogrammet för att gå igenom koden. När du går igenom koden markeras den aktuella raden i cellen. Du kan visa variabelvärden i fönstret variabelutforskaren i det högra sidofältet.

När du går igenom en funktion visas lokala funktionsvariabler i variabelfönstret, märkta [local].

Felsökningskonsol

När du startar en felsökningssession visas felsökningskonsolen automatiskt i den nedre panelen. Med den här konsolen kan du köra Python-kod för att inspektera eller ändra variabler när du pausar vid en brytpunkt. Kod som körs i huvudanteckningsboken körs inte under en felsökningssession. Tryck på Retur för att köra kod i konsolen. För flerradsuttryck använder du Skift + Retur för att flytta till en ny rad.

debug_console

Kommentar

  • Felsökningskonsolen är utformad för snabba utvärderingar och tidsgränser om kodkörningen överskrider 15 sekunder.
  • Kommandot display stöds inte i felsökningskonsolen. Om du vill visa exempeldata från en DataFrame använder du df.show() för PySpark DataFrames eller df.head() för Pandas DataFrames.

Variabelutforskaren

Du kan använda panelen ikonen för variabelutforskaren variabelutforskaren till höger för att visa värdena för dina variabler. När du klickar på Inspektera körs kod automatiskt i felsökningskonsolen för att mata ut värdet för variabeln.

exempel på panel för variabelutforskare

Om du vill filtrera visningen anger du text i sökrutan. Listan filtreras automatiskt när du skriver.

För Python på Databricks Runtime 12.2 LTS och senare körs variablerna som en cell. För Scala, R och Python på Databricks Runtime 11.3 LTS och nedan uppdateras variabler när en cell har körts.

Avsluta en felsökningssession

Avsluta felsökningssessionen genom att klicka stoppknapp för felsökningsprogram längst upp till vänster i cellen eller klicka knapp för att stoppa notebook-filer överst i anteckningsboken. Felsökningssessionen avslutas också automatiskt efter 30 minuter om användaren inte använder verktygsfältet för felsökning eller felsökningskonsolen.

Felsöka med Databricks Assistant

Databricks Assistant är en kontextmedveten AI-assistent som kan hjälpa dig att felsöka din kod. Mer information finns i Använda Databricks Assistant i en notebook-cell .

Begränsningar

Mer information finns i Kända begränsningar för Databricks-notebook-filer .