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

W tym artykule opisano sposób używania Databricks Connect integracji w rozszerzeniu usługi Databricks dla Visual Studio Code do uruchamiania i debugowania pojedynczych plików Python (.py). Aby uzyskać informacje o rozszerzeniu, zobacz rozszerzenie Databricks dla Visual Studio Code.

Integracja usługi Databricks Connect umożliwia również uruchamianie i debugowanie komórek notesu. Zobacz Uruchamianie i debugowanie komórek notesu z użyciem Databricks Connect przy użyciu rozszerzenia Databricks dla Visual Studio Code.

Wymagania

Aby można było użyć narzędzia Databricks Connect z poziomu rozszerzenia usługi Databricks dla Visual Studio Code, musisz najpierw spełnić wymagania Databricks Connect. Te wymagania obejmują takie elementy, jak obszar roboczy z obsługą Unity Catalog, wymagania dotyczące obliczeń oraz wymagania dotyczące wersji dla lokalnej instalacji Python.

Aktywowanie środowiska wirtualnego Python

Aktywuj środowisko Python wirtualne dla projektu Python. Środowiska wirtualne Pythona pomagają upewnić się, że projekt korzysta z kompatybilnych wersji Pythona i pakietów Pythona (w tym przypadku pakietu Databricks Connect).

W okienku Konfiguracja :

1. Kliknij czerwony element Activate Virtual Environment w obszarze Python Environment.
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 Configuration w obszarze Python Environment:

1. Kliknij czerwony przycisk Uruchom instalację Databricks-connect.
2. Dołącz klaster.
   • 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 Visual Studio Code pojawi się czerwony przycisk Databricks Connect wyłączony, kliknij go i wykonaj instrukcje wyświetlane na ekranie, aby go włączyć.
5. Po pojawieniu się przycisku Databricks Connect Włączone, możesz teraz korzystać z usługi Databricks Connect.

Uwaga

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

poetry add databricks-connect==16.4.1

Uruchom lub debugowanie kodu Python

Po włączeniu programu Databricks Connect uruchom lub debuguj plik Python (.py):

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

2. Ustaw wszystkie punkty przerwania debugowania w pliku Python.

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

   

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

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