Dela via

Felsöka anteckningsböcker

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

För att få åtkomst till felsökningsprogrammet måste din notebook vara ansluten till en av de följande beräkningsresurserna:

  • Serverlös databearbetning
  • Beräkning med åtkomstläge inställt på Standard (tidigare delat) i Databricks Runtime 14.3 LTS och senare
  • Beräkning med åtkomstläge inställt på Dedicated (tidigare enanvändare) i Databricks Runtime 13.3 LTS och senare
  • Beräkning med åtkomstläge inställt på Ingen isolering (delad) i Databricks Runtime 13.3 LTS eller senare

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 Developer.
  3. I avsnittet Redigeringsinställningar 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 marginalen på 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.
    • På cellkörningsmenyn väljer du Felsök cell.

    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

felsökningsverktygsfält med kommentarer

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

  • Ange eller ta bort brytpunkter.
  • Visa värdena för variabler vid en brytpunkt.
  • Steppa igenom koden.
  • Kliv in i eller ut ur en funktion.
  • Leta upp den rad som felsökningsprogrammet stoppas på.

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

Stega in i arbetsytefiler

Du kan ange brytpunkter och stega in i funktioner som definierats i andra arbetsytefiler när du aktiverar flikar för notebook-filer. Om du vill gå in i en funktion klickar du på steget i ikonen Pil nedpunktsikon.. Om funktionen definieras i en annan arbetsytefil öppnar felsökningsprogrammet filen på en ny flik.

stegexempel i

Kommentar

  • Felsökningsprogrammet kan bara gå in i funktioner som definierats i filer på arbetsytan. Det finns ännu inte stöd för att gå in på Python-bibliotek.
  • Om du redigerar externa filer när de har importerats kan notebook-sessionen fortfarande använda den gamla versionen av modulen. För att säkerställa att redigeringar av importerade moduler börjar gälla under felsökningen använder du autoreload för Python-moduler i Databricks Runtime 18.0+ eller serverlös beräkningsmiljö version 4+.

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 avslutas om kodkörningen överstiger 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 för variabelutforskaren ikonen för 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 uppdateras variablerna medan en cell körs. 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 på stoppknapp för felsökare längst upp till vänster i cellen eller på stoppknapp för anteckningsbok ö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 Assistant-kommandogenvägar för notebooks.

Begränsningar

Se Kända begränsningar för Databricks-notebooks för mer information.