Leggere in inglese

Condividi tramite

Che cos'è l'estensione Synapse Visual Studio Code?

  • Articolo

L'estensione Synapse Visual Studio Code supporta un'esperienza pro-sviluppatore per l’esplorazione di lakehouse di Microsoft Fabric e la creazione di notebook Fabric e definizioni processo Spark. Informazioni sull'estensione, tra cui come iniziare a con i prerequisiti necessari.

Visual Studio (VS) Code è uno degli editor di codice sorgente leggeri più popolari; viene eseguito sul desktop ed è disponibile per Windows, macOS e Linux. Installando l'estensione Synapse VS Code, è possibile creare, eseguire ed eseguire il debug del notebook e della definizione processo Spark in locale in VS Code. È anche possibile pubblicare il codice nell’ambiente di calcolo Spark remoto nell'area di lavoro di Fabric per l’esecuzione o il debug. L'estensione consente anche di esplorare i dati lakehouse, incluse tabelle e file non elaborati, in VS Code.

Prerequisiti

Prerequisiti per l'estensione Synapse VS Code:

Dopo aver installato il software necessario, è necessario aggiornare le proprietà del sistema operativo.

Windows

  1. Aprire Le impostazioni di Windows e cercare l'impostazione "Modifica le variabili di ambiente di sistema".

  2. In Variabili di sistema cercare la variabile JAVA_HOME. Se non esiste, fare clic sul pulsante Nuovo, immettere il nome della variabile JAVA_HOME e aggiungere la directory in cui è installato Java nel campo valore della variabile.

    Ad esempio, se si installa JDK in questo percorso C:\Program Files\Java\jdk-1.8, impostare il valore della variabile JAVA_HOME su tale percorso.

  3. In Variabili di sistema cercare la variabile Percorso e fare doppio clic su tale riga. Aggiungere i percorsi di cartella seguenti alla variabile percorso facendo clic sul pulsante Nuovo e aggiungendo il percorso della cartella:

    • %JAVA_HOME%/bin

    Per Conda aggiungere le sottocartelle seguenti dell'installazione di Conda. Aggiungere i percorsi completi delle cartelle per le sottocartelle

    • \miniconda3\condsbin
    • \miniconda3\Scripts

    Ad esempio: C:\Users\john.doe\AppData\Local\miniconda3\condsbin

macOS

Nel terminale, eseguire conda.sh:

  1. Aprire la finestra del terminale, cambiare directory scegliendo la cartella in cui è installato conda, quindi passare alla sottodirectory etc/profile.d. La sottodirectory deve contenere un file denominato conda.sh.

  2. Eseguire source conda.sh.

  3. Nella finestra del terminale, eseguire sudo conda init.

  4. Immettere Java --version. La versione deve essere Java 1.8.

Installare l’estensione e preparare l’ambiente

  1. Cercare Synapse VS Code nel marketplace dell'estensione VS Code e installare l'estensione.

  2. Al termine dell'installazione, riavviare VS Code. L'icona per l'estensione è elencata nella barra delle attività di VS Code.

Directory di lavoro locale

Per modificare un notebook, è necessaria una copia locale del contenuto del notebook. La directory di lavoro locale dell'estensione funge da cartella radice locale per tutti i notebook scaricati, anche quelli provenienti da aree di lavoro diverse. Richiamando il comando Synapse:Set Local Work Folder, è possibile specificare una cartella come directory di lavoro locale per l'estensione.

Per convalidare l'installazione, aprire le impostazioni dell'estensione e controllare i dettagli presenti:

Screenshot della schermata Impostazioni che mostra la directory di lavoro locale selezionata.

Accedere e disconnettersi dal proprio account

  1. Nel riquadro comandi di VS Code immettere il comando Synapse:Sign in per accedere all'estensione. Appare una pagina di accesso separata del browser.

  2. Immettere nome utente e password.

  3. Dopo aver eseguito l'accesso, il nome utente verrà visualizzato nella barra di stato di VS Code per indicare che è stato eseguito l'accesso.

    Screenshot della barra di stato di VS Code che mostra dove trovare lo stato di accesso.

  4. Per disconnettersi dall'estensione, immettere il comando Synapse: Sign off.

Scegliere un'area di lavoro da usare

Per selezionare un'area di lavoro di Fabric, è necessario aver creato un'area di lavoro. Se non ne è disponibile una, è possibile crearne una nel portale di Fabric. Per altre informazioni, vedere Creare un'area di lavoro.

Dopo aver creato un'area di lavoro, sceglierla selezionando l'opzione Seleziona area di lavoro. Appare un elenco di tutte le aree di lavoro a cui si ha accesso; selezionare quella desiderata dall'elenco.

Screenshot di Visual Studio Code Explorer che mostra dove trovare l'opzione Seleziona area di lavoro.

Limitazioni correnti

  • L'estensione in modalità desktop non supporta ancora le utilità di Microsoft Spark
  • L’inizio del comando della shell con "!" non è supportato.

Contenuto correlato

In questa panoramica si ottiene una conoscenza di base di come installare e configurare l'estensione Synapse VS Code. Gli articoli successivi illustrano come sviluppare notebook e definizioni processo Spark in locale in VS Code.