Debugowanie notesów

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

Na tej stronie opisano sposób korzystania z wbudowanego interaktywnego debugera w notesie usługi Databricks. Debuger jest dostępny tylko dla języka Python.

Interaktywny debuger udostępnia punkty przerwania, wykonywanie krok po kroku, inspekcję zmiennych i inne narzędzia ułatwiające wydajniejsze tworzenie kodu w notesach.

Wymagania

Aby uzyskać dostęp do debugera, notes musi być połączony z jednym z następujących zasobów obliczeniowych:

• Bezserwerowe usługi obliczeniowe
• Klaster z trybem dostępu ustawionym na pojedynczego użytkownika w środowisku Databricks Runtime 13.3 LTS lub nowszym
• Klaster z trybem dostępu ustawionym na wartość Brak izolacji udostępnionej w środowisku Databricks Runtime 13.3 LTS lub nowszym
• Klaster z trybem dostępu ustawionym na Wartość Udostępniona w środowisku Databricks Runtime 14.3 LTS lub nowszym

Włączanie debugera

Aby włączyć debuger, wykonaj następujące czynności:

1. Kliknij swoją nazwę użytkownika w prawym górnym rogu obszaru roboczego i wybierz pozycję Ustawienia z listy rozwijanej.
2. Na pasku bocznym Ustawienia wybierz pozycję Deweloper.
3. W sekcji Funkcje eksperymentalne przełącz interaktywny debuger notesu języka Python.

Rozpocznij debugowanie

Aby uruchomić debuger, wykonaj następujące kroki:

1. Dodaj co najmniej jeden punkt przerwania, klikając w rynnach komórki. Aby usunąć punkt przerwania, kliknij go ponownie.

   

2. Uruchom sesję debugowania przy użyciu jednej z następujących opcji:

   • Kliknij pozycję Uruchom > komórkę debugowania.
   • Użyj skrótu klawiaturowego Opcja + Shift + D.
   • Z menu uruchamiania komórki wybierz pozycję Debuguj komórkę.

   

Sesja debugowania jest uruchamiana automatycznie i uruchamia wybraną komórkę.

Możesz również uruchomić debuger, jeśli komórka wyzwoli błąd. W dolnej części danych wyjściowych komórki kliknij pozycję .

Gdy sesja debugowania jest aktywna, w górnej części komórki zostanie wyświetlony pasek narzędzi debugowania.

Akcje debugowania

W sesji debugowania można wykonać następujące czynności:

• Ustaw lub usuń punkty przerwania.
• Wyświetlanie wartości zmiennych w punkcie przerwania.
• Wykonaj krok po kodzie.
• Przechodzenie do funkcji lub poza jej działaniem.

Gdy kod osiągnie punkt przerwania, zatrzymuje się przed uruchomieniem wiersza, a nie po nim.

Użyj przycisków na pasku narzędzi debugera, aby przejść przez kod. Podczas przechodzenia przez kod bieżący wiersz jest wyróżniony w komórce. Wartości zmiennych można wyświetlić w okienku Eksploratora zmiennych na prawym pasku bocznym.

Po przejściu przez funkcję lokalne zmienne funkcji są wyświetlane w okienku zmiennej oznaczone jako [local].

Konsola debugowania

Po rozpoczęciu sesji debugowania konsola debugowania zostanie automatycznie wyświetlona w dolnym panelu. Ta konsola umożliwia wykonywanie kodu w języku Python w celu inspekcji zmiennych lub manipulowania nimi po wstrzymaniu w punkcie przerwania. Kod wykonywany w notesie głównym nie jest uruchamiany podczas sesji debugowania. Aby uruchomić kod w konsoli programu , naciśnij Enter. W przypadku wyrażeń wielowierszowych użyj Shift + Enter , aby przejść do nowego wiersza.

Uwaga

• Konsola debugowania jest przeznaczona do szybkiej oceny i przekracza limit czasu, jeśli wykonanie kodu przekroczy 15 sekund.
• Polecenie display nie jest obsługiwane w konsoli debugowania. Aby wyświetlić przykładowe dane z ramki danych, użyj dla df.show() ramek danych PySpark lub df.head() ramek danych Biblioteki Pandas.

Eksplorator zmiennych

Możesz użyć panelu eksploratora zmiennych po prawej stronie, aby wyświetlić wartości zmiennych. Kliknięcie pozycji Inspekcja powoduje automatyczne wykonanie kodu w konsoli debugowania w celu wyprowadzenia wartości zmiennej.

Aby filtrować wyświetlanie, wprowadź tekst w polu wyszukiwania. Lista jest filtrowana automatycznie podczas wpisywania.

W przypadku języka Python w środowisku Databricks Runtime 12.2 LTS lub nowszym zmienne są aktualizowane w miarę uruchamiania komórki. W przypadku języków Scala, R i Python w środowisku Databricks Runtime 11.3 LTS i nowszych zmienne są aktualizowane po zakończeniu działania komórki.

Kończenie sesji debugera

Aby zakończyć sesję debugowania, kliknij w lewym górnym rogu komórki lub kliknij w górnej części notesu. Sesja debugowania również automatycznie kończy się po 30 minutach, jeśli użytkownik nie korzysta z paska narzędzi debugowania ani konsoli debugowania.

Debugowanie za pomocą asystenta usługi Databricks

Asystent usługi Databricks to asystent sztucznej inteligencji obsługujący kontekst, który może ułatwić debugowanie kodu. Aby uzyskać więcej informacji, zobacz skróty poleceń asystenta dla notatników.

Ograniczenia

Aby uzyskać więcej informacji, zobacz Znane ograniczenia dotyczące notesów usługi Databricks.