Udostępnij za pośrednictwem


Debugowanie kodu przy użyciu usługi Databricks Connect dla rozszerzenia usługi Databricks dla programu Visual Studio Code

W tym artykule opisano sposób korzystania z integracji usługi Databricks Connect w rozszerzeniu Databricks dla programu Visual Studio Code w celu uruchamiania i debugowania poszczególnych plików języka Python (.py). Zobacz Co to jest rozszerzenie usługi Databricks dla programu Visual Studio Code?.

Integracja usługi Databricks Connect umożliwia również uruchamianie i debugowanie komórek notesu. Zobacz Run and debug notebook cells with Databricks Connect using the Databricks extension for Visual Studio Code (Uruchamianie i debugowanie komórek notesu za pomocą programu Databricks Connect przy użyciu rozszerzenia databricks dla programu Visual Studio Code).

Wymagania

Przed rozpoczęciem korzystania z usługi Databricks Connect z poziomu rozszerzenia Databricks dla programu Visual Studio Code należy najpierw spełnić wymagania dotyczące programu Databricks Connect. Te wymagania obejmują takie elementy jak obszar roboczy z obsługą wykazu aparatu Unity, wymagania dotyczące obliczeń i wymagania dotyczące wersji dla lokalnej instalacji języka Python.

Aktywowanie środowiska wirtualnego języka Python

Aktywowanie środowiska wirtualnego języka Python dla projektu w języku Python. Środowiska wirtualne języka Python pomagają upewnić się, że projekt korzysta z zgodnych wersji pakietów python i Python (w tym przypadku pakietu Databricks Connect).

W okienku Konfiguracja :

  1. Kliknij czerwony element Aktywuj środowisko wirtualne w obszarze Środowisko języka Python.
  2. W palecie poleceń wybierz pozycję Venv lub Conda.
  3. Wybierz zależności, które chcesz zainstalować, jeśli istnieją.

Instalowanie usługi Databricks Connect

W widoku Konfiguracja w obszarze Środowisko języka Python:

  1. Kliknij czerwony przycisk Zainstaluj usługę Databricks-connect play.
  2. Dołączanie klastra.
    • Jeśli sekcja Klaster nie została jeszcze skonfigurowana w rozszerzeniu, zostanie wyświetlony następujący komunikat: "Dołącz klaster do korzystania z usługi Databricks Connect". Kliknij pozycję Dołącz klaster i wybierz klaster spełniający wymagania programu Databricks Connect.
    • Jeśli sekcja Klaster jest skonfigurowana, ale klaster nie jest zgodny z usługą Databricks Connect, kliknij czerwony przycisk Wyłączone połączenie usługi Databricks, kliknij pozycję Dołącz klaster i wybierz zgodny klaster.
  3. Jeśli pakiet Databricks Connect (i jego zależności) nie jest jeszcze zainstalowany, zostanie wyświetlony następujący komunikat: "W przypadku interaktywnego debugowania i autouzupełniania potrzebujesz narzędzia Databricks Connect. Czy chcesz zainstalować go w środowisku <environment-name>." Kliknij przycisk Zainstaluj.
  4. Jeśli na pasku stanu programu Visual Studio Code pojawi się czerwony przycisk Wyłączony program Databricks Connect, kliknij go i ukończ instrukcje na ekranie, aby je włączyć.
  5. Po pojawieniu się przycisku Włączone połączenie usługi Databricks możesz teraz przystąpić do korzystania z usługi Databricks Connect.

Uwaga

Jeśli używasz poezji, możesz zsynchronizować pliki pyproject.toml i poetry.lock z zainstalowanym pakietem Databricks Connect (i jego zależnościami), uruchamiając następujące polecenie. Pamiętaj, aby zastąpić 13.3.2 wersję pakietu Databricks Connect zgodną z wersją zainstalowaną przez rozszerzenie usługi Databricks dla programu Visual Studio Code dla projektu.

poetry add databricks-connect==13.3.2

Uruchamianie lub debugowanie kodu w języku Python

Po włączeniu narzędzia Databricks Connect uruchom lub debuguj plik języka Python (.py):

  1. W projekcie otwórz plik języka Python, który chcesz uruchomić lub debugować.

  2. Ustaw wszystkie punkty przerwania debugowania w pliku języka Python.

  3. Kliknij ikonę Uruchom w usłudze Databricks obok listy kart edytora, a następnie kliknij pozycję Databricks Connect: Debuguj bieżący plik.

    Debugowanie bieżącego pliku z ikony

    Dane wyjściowe są wyświetlane w okienku Konsola debugowania.

    Możesz również kliknąć plik prawym przyciskiem myszy.py, a następnie kliknąć polecenie Uruchom w usłudze Databricks>Databricks Connect: Debuguj bieżący plik.

    Debugowanie bieżącego pliku z menu kontekstowego