Delen via


Wat is de Synapse Visual Studio Code-extensie?

De Synapse Visual Studio Code-extensie biedt ondersteuning voor een professionele ontwikkelaarservaring voor het verkennen van Microsoft Fabric Lakehouses en het ontwerpen van Fabric-notebooks en Spark-taakdefinities. Meer informatie over de extensie, waaronder hoe u aan de slag gaat met de vereiste vereisten.

Visual Studio (VS) Code is een van de populairste lichtgewicht broncode-editors; deze wordt uitgevoerd op uw bureaublad en is beschikbaar voor Windows, macOS en Linux. Door de Synapse VS Code-extensie te installeren, kunt u lokaal in VS Code uw notebook en Spark-taakdefinitie ontwerpen, uitvoeren en fouten opsporen. U kunt de code ook posten op de externe Spark-berekening in uw Fabric-werkruimte om uit te voeren of fouten op te sporen. Met de extensie kunt u ook door uw lakehouse-gegevens bladeren, inclusief tabellen en onbewerkte bestanden, in VS Code.

Voorwaarden

Vereisten voor de Synapse VS Code-extensie:

  • Installeer Java Development Kit (JDK) vanaf de OpenJDK8-website. Zorg ervoor dat u de JDK-koppeling gebruikt en niet de JRE.
  • Installeer Conda.
  • Installeer de jupyter-extensie voor VS Code

Nadat u de vereiste software hebt geïnstalleerd, moet u de eigenschappen van het besturingssysteem bijwerken.

Ramen

  1. Open de Windows-instellingen en zoek naar de instelling 'Bewerk de omgevingsvariabelen van het systeem'.

  2. Zoek onder Systeemvariabelen naar de variabele JAVA_HOME. Als deze niet bestaat, klikt u op de knop Nieuwe, voert u de naam van de variabele in JAVA_HOME en voegt u de map toe waarin Java is geïnstalleerd in het veld variabelewaarde.

    Als u bijvoorbeeld JDK op dit pad installeert C:\Program Files\Java\jdk-1.8, stelt u de waarde van de JAVA_HOME variabele in op dat pad.

  3. Zoek onder Systeemvariabelen naar de variabele Path en dubbel-klik op die rij. Voeg de volgende mappaden toe aan de variabele Pad door op de knop Nieuw te klikken en het mappad toe te voegen.

    • %JAVA_HOME%/bin

    Voeg voor Conda de volgende submappen van de Conda-installatie toe. Voeg de volledige paden van deze submappen toe.

    • \miniconda3\condsbin
    • \miniconda3\Scripts

    Bijvoorbeeld: C:\Users\john.doe\AppData\Local\miniconda3\condsbin

macOS

Voer de conda.sh uit in de terminal:

  1. Open het terminalvenster, wijzig de map in de map waarin Conda is geïnstalleerd en ga vervolgens naar de submap etc/profile.d. De submap moet een bestand met de naam conda.shbevatten.

  2. Voer source conda.shuit.

  3. Voer in hetzelfde terminalvenster sudo conda inituit.

  4. Typ Java --version. De versie moet Java 1.8 zijn.

De extensie installeren en uw omgeving voorbereiden

  1. Zoek Synapse VS Code in de VS Code-extensie marketplace en installeer de extensie.

  2. Nadat de installatie van de extensie is voltooid, start u VS Code opnieuw. Het pictogram voor de extensie wordt weergegeven op de activiteitenbalk van VS Code.

Lokale werkmap

Als u een notitieblok wilt bewerken, moet u een lokale kopie van de inhoud van het notitieblok hebben. De lokale werkmap van de extensie fungeert als de lokale hoofdmap voor alle gedownloade notitieblokken, zelfs notebooks uit verschillende werkruimten. Door de opdracht Synapse:Set Local Work Folderaan te roepen, kunt u een map opgeven als de lokale werkmap voor de extensie.

Als u de installatie wilt valideren, opent u de extensie-instellingen en controleert u de details daar:

Schermopname van het scherm Instellingen, met de geselecteerde lokale werkmap.

Aanmelden en afmelden bij uw account

  1. Voer in het opdrachtenpalet van VS Code de Synapse:Sign in opdracht in om u aan te melden bij de extensie. Er wordt een afzonderlijke aanmeldingspagina van de browser weergegeven.

  2. Voer uw gebruikersnaam en wachtwoord in.

  3. Nadat u zich hebt aangemeld, wordt uw gebruikersnaam weergegeven op de statusbalk van VS Code om aan te geven dat u bent aangemeld.

    Schermopname van de statusbalk van VS Code, waarin wordt weergegeven waar u de aanmeldingsstatus kunt vinden.

  4. Als u zich wilt afmelden bij de extensie, voert u de opdracht Synapse: Sign offin.

Een werkruimte kiezen waarmee u wilt werken

Om een Fabric-werkruimte te selecteren, moet u al een werkruimte hebben aangemaakt. Als u er nog geen hebt, kunt u er een maken in de Fabric-portal. Zie Een werkruimte makenvoor meer informatie.

Wanneer u een werkruimte hebt, kiest u deze door de optie Werkruimte selecteren te selecteren. Er wordt een lijst weergegeven met alle werkruimten waartoe u toegang hebt; selecteer de gewenste optie in de lijst.

schermopname van VS Code Explorer, waarin wordt weergegeven waar u de optie Werkruimte selecteren kunt vinden.

Huidige beperkingen

  • De extensie onder de bureaubladmodus biedt nog geen ondersteuning voor de Microsoft Spark-hulpprogramma's
  • Een shell-opdracht die begint met '!' wordt niet ondersteund.

In dit overzicht krijgt u basiskennis van het installeren en instellen van de Synapse VS Code-extensie. In de volgende artikelen wordt uitgelegd hoe u uw notebooks en Spark-taakdefinities lokaal kunt ontwikkelen in VS Code.