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

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

Met de Connect Databricks-integratie kunt u ook notebookcellen uitvoeren en debuggen. Zie Notebook-cellen uitvoeren en debuggen met Databricks Connect en 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 vereisten voor Databricks Connect. Deze vereisten omvatten zaken zoals een werkruimte met Unity Catalog, rekenvereisten en versievereisten voor uw lokale installatie van Python.

Een Python virtuele omgeving activeren

Activeer een Python virtuele omgeving voor uw Python project. Python virtuele 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 Environment.
2. Selecteer Venv of Conda in het opdrachtpalet.
3. Selecteer de afhankelijkheden die u wilt installeren, indien van toepassing.

Databricks Connect installeren

In de weergave Configuration onder Python Environment:

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 Visual Studio Code statusbalk de rode Databricks Connect is uitgeschakeld wordt weergegeven, klikt u erop en voert u de instructies op het scherm uit om deze 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. Vervang 16.4.1 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==16.4.1

Je Python-code uitvoeren of debuggen

Nadat u Databricks Connect hebt ingeschakeld, voert u uw Python-bestand uit (.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.