Freigeben über

Was ist die Synapse Visual Studio Code-Erweiterung?

  • Artikel

Die Synapse Visual Studio Code-Erweiterung unterstützt entwicklerfreundliche Funktionen zum Erkunden von Microsoft Fabric-Lakehouses und zum Erstellen von Fabric-Notebooks und Spark-Auftragsdefinitionen. Erfahren Sie mehr über die Erweiterung, einschließlich der ersten Schritte mit den erforderlichen Voraussetzungen.

Visual Studio (VS) Code ist einer der beliebtesten einfachen Quellcode-Editoren. Er wird auf Ihrem Desktop ausgeführt und ist für Windows, macOS und Linux verfügbar. Durch Installieren der Synapse VS Code-Erweiterung können Sie Ihre Notebook- und Spark-Auftragsdefinition lokal in VS Code erstellen, ausführen und debuggen. Darüber hinaus können Sie den Code auf der Spark-Remotecompute in Ihrem Fabric-Arbeitsbereich veröffentlichen, um ihn auszuführen oder zu debuggen. Mit der Erweiterung können Sie ferner Ihre Lakehouse-Daten, einschließlich Tabellen und Rohdateien, in VS Code durchsuchen.

Voraussetzungen

Voraussetzungen für die Synapse VS Code-Erweiterung:

Nachdem Sie die erforderliche Software installiert haben, müssen Sie die Betriebssystemeigenschaften aktualisieren.

Windows

  1. Fügen Sie JAVA_HOME zu den Umgebungsvariablen hinzu, und verweisen Sie auf das Verzeichnis, in dem Java 1.8 installiert ist. Wenn Sie z. B. JDK auf diesem Pfad C:\Program Files\Java\jdk-1.8 installieren, müssen Sie den JAVA_HOME-Variablenwert auf diesen Pfad festlegen.

  2. Fügen Sie sowohl %JAVA_HOME%/bin als auch den Unterordner Condabin der Conda-Installation zum Systempfadverzeichnis hinzu. Der Ordner Condabin könnte sich in dem Ordner der Installation befinden und das Format \miniconda3\condsbin haben. Öffnen Sie die Umgebungsvariablen und fügen Sie die Pfade %JAVA_HOME%/bin und condabin zur Variable Pfad hinzu.

macOS

Führen Sie conda.sh im Terminal aus:

  1. Öffnen Sie das Terminalfenster, ändern Sie das Verzeichnis in den Ordner, in dem Conda installiert ist, und wechseln Sie dann in das Unterverzeichnis etc/profile.d. Das Unterverzeichnis sollte eine Datei mit dem Namen conda.sh enthalten.

  2. Führen Sie source conda.sh aus.

  3. Führen Sie im selben Terminalfenster sudo conda init aus.

  4. Geben Sie Java --version ein. Es sollte sich um die Version Java 1.8 handeln.

Installieren der Erweiterung und Vorbereiten Ihrer Umgebung

  1. Suchen Sie im VS Code-Erweiterungs-Marketplace nach Synapse VS Code, und installieren Sie die Erweiterung.

  2. Starten Sie VS Code neu, nachdem die Installation der Erweiterung abgeschlossen ist. Das Symbol für die Erweiterung wird auf der VS Code-Aktivitätsleiste aufgeführt.

Lokales Arbeitsverzeichnis

Zum Bearbeiten eines Notebooks benötigen Sie eine lokale Kopie des Notebookinhalts. Das lokale Arbeitsverzeichnis der Erweiterung dient als lokaler Stammordner für alle heruntergeladenen Notebooks, auch für Notebooks aus anderen Arbeitsbereichen. Durch Aufrufen des Befehls Synapse:Set Local Work Folder können Sie einen Ordner als lokales Arbeitsverzeichnis für die Erweiterung angeben.

Um das Setup zu überprüfen, öffnen Sie die Erweiterungseinstellungen, und überprüfen Sie dort die Details:

Screenshot: Bildschirm „Einstellungen“ mit dem ausgewählten lokalen Arbeitsverzeichnis.

An- und Abmelden bei Ihrem Konto

  1. Geben Sie in der VS Code-Befehlspalette den Befehl Synapse:Sign in ein, um sich bei der Erweiterung anzumelden. Eine separate Browseranmeldungsseite wird angezeigt.

  2. Geben Sie Ihren Benutzernamen und Ihr Kennwort ein.

  3. Nachdem Sie sich erfolgreich angemeldet haben, wird Ihr Benutzername in der VS Code-Statusleiste angezeigt, um anzuzeigen, dass Sie angemeldet sind.

    Screenshot: VS Code-Statusleiste mit Angabe der Position Ihres Anmeldestatus.

  4. Geben Sie zum Abmelden bei der Erweiterung den Befehl Synapse: Sign off ein.

Auswählen eines Arbeitsbereichs für die Arbeit

Damit Sie einen Fabric-Arbeitsbereich auswählen können, muss ein Arbeitsbereich erstellt worden sein. Wenn Sie noch keinen besitzen, können Sie einen mithilfe des Fabric-Portals erstellen. Weitere Informationen finden Sie unter Erstellen eines Arbeitsbereichs.

Sobald Sie über einen Arbeitsbereich verfügen, wählen Sie ihn aus, indem Sie die Option Arbeitsbereich auswählen auswählen. Es wird eine Liste aller Arbeitsbereiche angezeigt, auf die Sie Zugriff haben. Wählen Sie den gewünschten in der Liste aus.

Screenshot: VS Code-Explorer mit Markierung der Position der Option „Arbeitsbereich auswählen“.

Aktuelle Einschränkungen

  • Die Erweiterung im Desktopmodus unterstützt die Microsoft Spark-Hilfsprogramme noch nicht.
  • Shell-Befehle, die mit „!“ beginnen, werden nicht unterstützt.

Zugehöriger Inhalt

In dieser Übersicht erwerben Sie ein grundlegendes Verständnis von Installation und Einrichtung der Synapse VS Code-Erweiterung. In den nächsten Artikeln wird erläutert, wie Sie Ihre Notebooks und Spark-Auftragsdefinitionen lokal in VS Code entwickeln.