Debuggen von Code mithilfe von Databricks Connect für die Databricks-Erweiterung für Visual Studio Code

In diesem Artikel wird beschrieben, wie Sie mithilfe der Databricks Connect-Integration in der Databricks-Erweiterung für Visual Studio Code einzelne Python-Dateien (.py) ausführen und debuggen können. Weitere Informationen finden Sie unter Was ist die Databricks-Erweiterung für Visual Studio Code?.

Die Databricks Connect-Integration ermöglicht ihnen auch das Ausführen und Debuggen von Notebookzellen. Siehe Ausführen und Debuggen von Notebookzellen mit Databricks Connect mithilfe der Databricks-Erweiterung für Visual Studio Code.

Anforderungen

Bevor Sie Databricks Connect aus der Databricks-Erweiterung für Visual Studio Code verwenden können, müssen Sie zunächst die Anforderungen für Databricks Connect erfüllen. Zu diesen Anforderungen gehören z. B. ein Unity Catalog-fähiger Arbeitsbereich, Computeanforderungen und Versionsanforderungen für Ihre lokale Installation von Python.

Aktivieren einer virtuellen Python-Umgebung

Aktivieren Sie eine virtuelle Python-Umgebung für Ihr Python-Projekt. Mit virtuellen Python-Umgebungen können Sie sicherstellen, dass Ihr Projekt kompatible Versionen von Python und Python-Paketen verwendet (in diesem Fall das Databricks Connect-Paket).

Gehen Sie im Bereich Konfiguration folgendermaßen vor:

1. Klicken Sie unter Python-Umgebung auf das rote Element Virtuelle Umgebung aktivieren.
2. Wählen Sie in der Befehlspalette Venv oder Conda aus.
3. Wählen Sie die gegebenenfalls zu installierenden Abhängigkeiten aus.

Installieren Sie Databricks Connect

In der Ansicht Konfiguration unter Python-Umgebung:

1. Klicken Sie auf die rote Schaltfläche Databricks Connect installieren.
2. Fügen Sie einen Cluster an.
   • Wenn der Abschnitt Cluster noch nicht in der Erweiterung konfiguriert ist, wird eine mit der folgenden vergleichbare Meldung angezeigt: „Fügen Sie einen Cluster an, um Databricks Connect zu verwenden.“ Klicken Sie auf Cluster anfügen, und wählen Sie einen Cluster aus, der die Anforderungen für Databricks Connect erfüllt.
   • Wenn der Abschnitt Cluster konfiguriert ist, der Cluster jedoch nicht mit Databricks Connect kompatibel ist, klicken Sie auf die rote Schaltfläche Databricks Connect deaktiviert, klicken Sie auf Cluster anfügen, und wählen Sie einen kompatiblen Cluster aus.
3. Wenn das Databricks Connect-Paket (und seine Abhängigkeiten) noch nicht installiert ist, wird die folgende Meldung angezeigt: „Für das interaktive Debuggen und die automatische Vervollständigung benötigen Sie Databricks Connect. Möchten Sie es in der Umgebung <environment-name> installieren?“ Klicken Sie auf Installieren.
4. Wenn die rote Schaltfläche Databricks Connect deaktiviert in der Statusleiste von Visual Studio Code angezeigt wird, klicken Sie darauf und befolgen Sie die Anweisungen auf dem Bildschirm zum Aktivieren.
5. Nachdem die Schaltfläche Databricks Connect aktiviert angezeigt wurde, können Sie Databricks Connect verwenden.

Hinweis

Wenn Sie Poetry verwenden, können Sie die Dateien pyproject.toml und poetry.lock mit dem installierten Databricks Connect-Paket (und dessen Abhängigkeiten) synchronisieren, indem Sie den folgenden Befehl ausführen. Ersetzen Sie 13.3.2 unbedingt durch die Version des Databricks Connect-Pakets, die mit der Version übereinstimmt, die von der Datenbricks-Erweiterung für Visual Studio Code für Ihr Projekt installiert wurde.

poetry add databricks-connect==13.3.2

Ausführen oder Debuggen Ihres Python-Codes

Wenn Sie Databricks Connect aktiviert haben, können Sie Ihre Python-Datei (.py) ausführen oder debuggen:

1. Öffnen Sie in Ihrem Projekt die Python-Datei, die Sie ausführen oder debuggen möchten.

2. Legen Sie Debug-Breakpoints in der Python-Datei fest.

3. Klicken Sie neben der Liste der Editorregisterkarten auf das Symbol In Databricks ausführen und dann auf Databricks Connect: Aktuelle Datei debuggen.

   

   Die Ausgabe wird in der Debugging-Konsole angezeigt.

   Sie können auch mit der rechten Maustaste auf die Datei .py klicken und dann auf In Databricks ausführen>Databricks Connect: Aktuelle Datei debuggen klicken.