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. Aggiungere JAVA_HOME alle variabili di ambiente e puntare alla directory in cui è installato Java 1.8. 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.

  2. Aggiungere sia %JAVA_HOME%/bin che la sottocartella condabin dell'installazione di Conda alla directory del percorso di sistema. La cartella condabin potrebbe trovarsi nella cartella in cui è stato installato e in questo formato \miniconda3\condsbin. Aprire le variabili di ambiente e aggiungere %JAVA_HOME%/bin e percorsi condabin alla variabile Path.

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.