Condividi tramite


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

L'estensione Synapse Visual Studio Code supporta un'esperienza pro-developer per esplorare i lakehouse di Microsoft Fabric e creare notebook di Fabric e definizioni di processi Spark. Altre informazioni sull'estensione, tra cui come iniziare a usare i prerequisiti necessari.

Visual Studio (VS) Code è uno dei più diffusi editor di codice sorgente leggero; 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 del processo Spark in locale in VS Code. È anche possibile pubblicare il codice nel calcolo Spark remoto nell'area di lavoro infrastruttura per eseguire o eseguire 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

Eseguire il conda.sh nel terminale:

  1. Aprire la finestra del terminale, modificare la directory nella 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 stessa finestra del terminale eseguire sudo conda init.

  4. Digitare 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 dell'estensione, riavviare VS Code. L'icona per l'estensione è elencata nella barra delle attività di VS Code.

Directory di lavoro locale

Per modificare un notebook, è necessario disporre di 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 i notebook 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 disponibili:

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

Accedere e disconnettersi dall'account

  1. Nel riquadro comandi di VS Code immettere il Synapse:Sign in comando per accedere all'estensione. Viene visualizzata 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 infrastruttura, è necessario creare un'area di lavoro. Se non ne è disponibile uno, è possibile crearne uno nel portale di Fabric. Per altre informazioni, vedere Creare un'area di lavoro.

Dopo aver creato un'area di lavoro, selezionarla selezionando l'opzione Seleziona area di lavoro . Viene visualizzato un elenco di tutte le aree di lavoro a cui si ha accesso; selezionare quello desiderato 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
  • Il comando shell inizia con "!" non è supportato.

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 di processi Spark in locale in VS Code.