Fouten opsporen in code met Databricks Connect voor de Databricks-extensie voor Visual Studio Code

In dit artikel wordt beschreven hoe u de Databricks Connect-integratie gebruikt in de Databricks-extensie voor Visual Studio Code om afzonderlijke Python-bestanden (.py) uit te voeren en fouten op te sporen. Voor informatie over de extensie, zie Wat is de Databricks-extensie voor Visual Studio Code?.

Met de Connect Databricks-integratie kunt u ook notebookcellen uitvoeren en debuggen. Zie Notebook-cellen uitvoeren en fouten opsporen met Databricks Connect met behulp van de Databricks-extensie voor Visual Studio Code.

Vereisten

Voordat u Databricks Connect kunt gebruiken vanuit de Databricks-extensie voor Visual Studio Code, moet u eerst voldoen aan de Databricks Connect-vereisten. Deze vereisten omvatten zaken zoals een werkruimte met Unity-catalogus, rekenvereisten en versievereisten voor uw lokale installatie van Python.

Een virtuele Python-omgeving activeren

Activeer een virtuele Python-omgeving voor uw Python-project. Virtuele Python-omgevingen helpen ervoor te zorgen dat uw project compatibele versies van Python- en Python-pakketten gebruikt (in dit geval het Databricks Connect-pakket).

In het deelvenster Configuratie :

1. Klik op het rode item Virtuele omgeving activeren onder Python-omgeving.
2. Selecteer Venv of Conda in het opdrachtpalet.
3. Selecteer de afhankelijkheden die u wilt installeren, indien van toepassing.

Databricks Connect installeren

In de configuratieweergave onder Python-omgeving:

1. Klik op de rode afspeelknop Databricks-connect.
2. Een cluster koppelen.
   • Als de sectie Cluster nog niet is geconfigureerd in de extensie, wordt het volgende bericht weergegeven: 'Koppel een cluster om Databricks Connect te gebruiken'. Klik op Koppel cluster en selecteer een cluster dat voldoet aan de Databricks Connect-vereisten.
   • Als de sectie Cluster is geconfigureerd, maar het cluster niet compatibel is met Databricks Connect, klikt u op de rode knop Databricks Connect uitgeschakeld, klikt u op Cluster koppelenen selecteert u een compatibel cluster.
3. Als het Databricks Connect-pakket (en de bijbehorende afhankelijkheden) nog niet zijn geïnstalleerd, wordt het volgende bericht weergegeven: 'Voor interactieve foutopsporing en automatisch aanvullen hebt u Databricks Connect nodig. wilt u deze installeren in de omgeving <environment-name>." Klik op Install.
4. Als in de statusbalk van Visual Studio Code de rode knop Databricks Connect uitgeschakeld verschijnt, klikt u erop en volgt u de instructies op het scherm om het in te schakelen.
5. Nadat de knop Databricks Connect is ingeschakeld , bent u nu klaar om Databricks Connect te gebruiken.

Notitie

Als u Poetry gebruikt, kunt u uw pyproject.toml- en poetry.lock-bestanden synchroniseren met het geïnstalleerde Databricks Connect-pakket (en de bijbehorende afhankelijkheden) door de volgende opdracht uit te voeren. Zorg ervoor dat u vervangt 13.3.2 door de versie van het Databricks Connect-pakket dat overeenkomt met het pakket dat is geïnstalleerd door de Databricks-extensie voor Visual Studio Code voor uw project.

poetry add databricks-connect==13.3.2

Uw Python-code uitvoeren of fouten opsporen

Nadat u Databricks Connect hebt ingeschakeld, voert u het Python-bestand uit of debugt u dit (.py):

1. Open in uw project het Python-bestand dat u wilt uitvoeren of fouten wilt opsporen.

2. Stel eventuele onderbrekingspunten voor foutopsporing in het Python-bestand in.

3. Klik op het pictogram Uitvoeren op Databricks naast de lijst met editortabbladen en klik vervolgens op Huidig bestand opsporen met Databricks Connect.

   

   De uitvoer wordt weergegeven in het deelvenster Console voor foutopsporing.

   U kunt ook met de rechtermuisknop op het .py-bestand klikken en vervolgens op Uitvoeren op Databricks>Fouten opsporen in het huidige bestand met Databricks Connect.