Estensione Databricks per Visual Studio Code

L'estensione Databricks per Visual Studio Code consente di connettersi alle aree di lavoro Azure Databricks remote da Visual Studio Code o Cursor nel computer di sviluppo locale. È quindi possibile:

• Definire, distribuire ed eseguire bundle di automazione dichiarativa per applicare modelli CI/CD e procedure consigliate ai processi Lakeflow, alle pipeline dichiarative di Lakeflow Spark e agli stack MLOps usando l'interfaccia utente di Visual Studio Code. Vedere Che cosa sono i bundle di automazione dichiarativa? e le funzionalità di estensione dei bundle di automazione dichiarativa.
• Eseguire file di codice Python locali da Visual Studio Code in cluster Azure Databricks o risorse di calcolo serverless nelle aree di lavoro remote. Vedere Eseguire un file di Python in un cluster.
• Esegui file di codice Python locali (.py) e notebook Python, R, Scala e SQL (.py, .ipynb, .r, .scala e .sql) da Visual Studio Code come job Lakeflow nelle aree di lavoro remote. Vedere Eseguire un file di Python come processo.
• Impostare e configurare l'ambiente di debugging e Databricks Connect usando una lista di controllo semplice che attiva le finestre di dialogo della selezione. Visualizzare il codice di debug usando Databricks Connect per l'estensione Databricks per Visual Studio Code.
• Eseguire il debug delle celle dei notebook per cella all'interno di Visual Studio Code con Databricks Connect. Vedi Esegui il debug delle celle del notebook con Databricks Connect utilizzando l'estensione Databricks per Visual Studio Code.
• Sincronizzare il codice locale sviluppato in Visual Studio Code con il codice nelle aree di lavoro remote. Consulta Sincronizza la cartella dell'area di lavoro con Databricks

Nota

L'estensione Databricks per Visual Studio Code supporta l'esecuzione di notebook R, Scala e SQL come processi automatizzati, ma non offre supporto più approfondito per questi linguaggi all'interno di Visual Studio Code.

Inizia

Per iniziare a usare l'estensione Databricks per Visual Studio Code:

• Installare l'estensione.
• Create un nuovo progetto databricks o convert un progetto di Visual Studio Code esistente.
• Configurare in modo semplice il progetto usando l'interfaccia utente dell'estensione Databricks.
• Eseguire codice Python come parte dell'esercitazione extension.
• Eseguire il debug del codice usando l'integrazione di Databricks Connect.
• Test del codice utilizzando pytest. Vedere Eseguire test di Python usando l'estensione Databricks per Visual Studio Code.

Creare un nuovo progetto databricks

Dopo aver installato l'estensione, è possibile creare un nuovo progetto Databricks usando l'estensione Databricks per Visual Studio Code:

1. Avviare Visual Studio Code.
2. Fare clic sull'icona Databricks nella barra laterale Visual Studio Code per aprire l'estensione.
3. Fare clic su Crea un nuovo progetto.
4. Nel riquadro comandi , selezionare un host e un metodo di autenticazione per il progetto. Vedere Impostare l'autorizzazione per l'estensione Databricks per Visual Studio Code.
5. In Fornire il percorso di una cartella in cui desideri che il nuovo progetto sia, immetti il percorso di una cartella sul tuo computer di sviluppo locale in cui vuoi creare il progetto, oppure fai clic su Apri finestra di dialogo per la selezione delle cartelle e seleziona il percorso della cartella del progetto.
6. Per Modello da usare nella visualizzazione di inizializzazione del progetto Databricks, usare le frecce su e giù per selezionare un modello di progetto e quindi premere INVIO. Per informazioni sui modelli di progetto bundle, vedere Modelli di progetto di automazione dichiarativa.
7. Digitare un nome univoco per questo progetto o lasciare il nome predefinito my_project, poi premere INVIO.
8. Scegli se aggiungere un notebook di esempio, una pipeline di esempio Delta Live Tables, un pacchetto Python di esempio al progetto o qualsiasi combinazione di questi esempi.
9. Premere un tasto qualsiasi per chiudere la scheda Databricks Project Init editor.
10. Per Selezionare il progetto da aprire, scegliere il progetto appena creato.

Aprire un progetto di bundle di automazione dichiarativa esistente

Un progetto di bundle di automazione dichiarativa ha un file databricks.yml nella cartella radice del progetto. Vedere Configurazione dei bundle di automazione dichiarativa. Se si vuole usare l'estensione con un progetto di bundle di automazione dichiarativa esistente:

1. Avviare Visual Studio Code. Dal menu principale fare clic su File>Apri cartella e passare alla directory che contiene il progetto bundle.

2. Fare clic sull'icona Databricks nella barra laterale Visual Studio Code per aprire e iniziare a usare le funzionalità dell'estensione.

   Se l'estensione Databricks per Visual Studio Code individua più di un progetto bundle di automazione dichiarativa nella cartella corrente, consente di scegliere di aprire un progetto o di creare un file di configurazione del progetto nella cartella radice.

   

   • Se si sceglie un progetto, nella Command Palette, selezionare il progetto esistente "Declarative Automation Bundles".
   • Se si crea una configurazione nella cartella radice, tale cartella diventa un progetto bundle.

3. Selezionare un host e un metodo di autenticazione per il progetto. Vedere Impostare l'autorizzazione per l'estensione Databricks per Visual Studio Code.

Nota

Se si apre un progetto creato usando l'estensione Databricks per Visual Studio Code v1, la migrazione viene tentata automaticamente usando l'autenticazione e la configurazione dell'area di lavoro esistenti del progetto. Il pulsante di migrazione è disponibile solo se la migrazione automatica ha esito negativo.

Passare da un progetto databricks all'altro

L'estensione Databricks per Visual Studio Code consente di avere più progetti Databricks all'interno dell'area di lavoro Visual Studio Code e passare facilmente da un'area di lavoro all'altra. Con il progetto multi-bundle aperto nell'area di lavoro di Visual Studio Code:

1. Fare clic sull'icona Databricks nella barra laterale Visual Studio Code per aprire l'estensione.

2. Fare clic su Cartella locale per selezionare il progetto che l'estensione deve usare.

   

Nota

Le azioni di esecuzione sono disponibili solo per i file nel bundle attivo.

Convertire un progetto in un progetto Databricks

Se si dispone di un progetto esistente che si vuole convertire in un progetto Databricks:

1. Avviare Visual Studio Code. Dal menu principale fare clic su File>Apri cartella e passare al progetto per aprirlo.
2. Fare clic sull'icona Databricks nella barra laterale Visual Studio Code per aprire l'estensione.
3. Fare clic su Crea configurazione.
4. Nel riquadro comandi , selezionare un host e un metodo di autenticazione per il progetto. Vedere Impostare l'autorizzazione per l'estensione Databricks per Visual Studio Code.