Het interactieve foutopsporingsprogramma van Databricks gebruiken

Belangrijk

Deze functie is beschikbaar als openbare preview.

Op deze pagina wordt beschreven hoe u het ingebouwde interactieve foutopsporingsprogramma gebruikt in het Databricks-notebook. Het foutopsporingsprogramma is alleen beschikbaar voor Python.

Het interactieve foutopsporingsprogramma biedt onderbrekingspunten, stapsgewijze uitvoering, variabele inspectie en meer hulpprogramma's waarmee u efficiënter code in notebooks kunt ontwikkelen.

Vereisten

Uw notebook moet zijn gekoppeld aan een cluster dat voldoet aan de volgende vereisten:

• Databricks Runtime versie 13.3 LTS of hoger.
• De toegangsmodus moet één gebruiker zijn (toegewezen) of geen isolatie gedeeld.

Het foutopsporingsprogramma in- of uitschakelen

Ga als volgt te werk om het foutopsporingsprogramma in of uit te schakelen:

1. Klik op uw gebruikersnaam rechtsboven in de werkruimte en selecteer Instellingen in de vervolgkeuzelijst.
2. Selecteer Ontwikkelaars in de zijbalk Instellingen.
3. Schakel in de sectie Experimentele functies het interactieve foutopsporingsprogramma van Python Notebook in.

Het foutopsporingsprogramma starten

Voer de volgende stappen uit om het foutopsporingsprogramma te starten:

1. Voeg een of meer onderbrekingspunten toe door in de rugmarge van een cel te klikken. Als u een onderbrekingspunt wilt verwijderen, klikt u er opnieuw op.

   

2. Voer een van de volgende stappen uit:

   • Klik op Foutopsporingscel uitvoeren>.
   • Gebruik de sneltoets Option + Shift + D.
   • Selecteer in het menu voor het uitvoeren van cellen de foutopsporingscel.

   

Er wordt automatisch een foutopsporingssessie gestart en de geselecteerde cel wordt uitgevoerd.

U kunt het foutopsporingsprogramma ook starten als een cel een fout activeert. Klik onder aan de uitvoer van de cel op .

Wanneer een foutopsporingssessie actief is, wordt de werkbalk voor foutopsporing boven aan de cel weergegeven.

Het foutopsporingsprogramma gebruiken

In een foutopsporingssessie kunt u het volgende doen:

• Onderbrekingspunten instellen of verwijderen.
• Bekijk de waarden van variabelen op een onderbrekingspunt.
• Doorloop de code.
• Stap in of uit een functie.

Wanneer de code een onderbrekingspunt bereikt, stopt deze voordat de regel wordt uitgevoerd, niet na.

Gebruik de knoppen in de werkbalk van het foutopsporingsprogramma om de code te doorlopen. Terwijl u de code doorloopt, wordt de huidige regel gemarkeerd in de cel. U kunt variabelewaarden weergeven in het deelvenster Variabeleverkenner in de rechterzijbalk.

Wanneer u een functie doorloopt, worden lokale functievariabelen weergegeven in het deelvenster met variabelen, gemarkeerd [local].

De foutopsporingsconsole gebruiken

Wanneer u een foutopsporingssessie start, wordt de console voor foutopsporing automatisch weergegeven in het onderste deelvenster. Met deze console kunt u Python-code uitvoeren om variabelen te inspecteren of te bewerken wanneer deze zijn onderbroken op een onderbrekingspunt. Code die wordt uitgevoerd in het hoofdnotebook, wordt niet uitgevoerd tijdens een foutopsporingssessie. Druk op Enter om code uit te voeren in de console. Voor expressies met meerdere regels gebruikt u Shift + Enter om naar een nieuwe regel te gaan.

Notitie

• De foutopsporingsconsole is ontworpen voor snelle evaluaties en een time-out als de uitvoering van de code langer is dan 15 seconden.
• De display opdracht wordt niet ondersteund in de console voor foutopsporing. Als u voorbeeldgegevens uit een DataFrame wilt weergeven, gebruikt df.show() u deze voor PySpark DataFrames of df.head() voor Pandas DataFrames.

De variabeleverkenner gebruiken

U kunt het deelvenster Variable Explorer aan de rechterkant gebruiken om de waarden van uw variabelen weer te geven. Als u op Inspect klikt, wordt code in de foutopsporingsconsole automatisch uitgevoerd om de waarde van uw variabele uit te voeren.

Een foutopsporingsprogrammasessie beëindigen

Als u de foutopsporingssessie wilt beëindigen, klikt u linksboven in de cel of klikt u bovenaan het notitieblok. De foutopsporingssessie wordt ook na 30 minuten automatisch beëindigd als de gebruiker de foutopsporingswerkbalk of foutopsporingsconsole niet gebruikt.

Beperkingen

Zie Bekende beperkingen voor Databricks-notebooks voor meer informatie.