Condividi tramite

Introduzione alle app databricks

Questo articolo illustra come iniziare a usare Databricks Apps usando un esempio dettagliato per creare una semplice app nell'area di lavoro di Azure Databricks usando un modello che segue le procedure consigliate di Azure Databricks.

Questo esempio illustra in dettaglio:

  • Creazione di un'app da un modello
  • Visualizzazione dell'app dopo la distribuzione
  • Copia del modello di app nel computer per un ulteriore sviluppo
  • Esecuzione dell'app in locale
  • Ridistribuire l'app nell'area di lavoro

Al termine di questo articolo, sarà possibile eseguire l'iterazione nell'app in locale e distribuire gli aggiornamenti in Databricks.

Prerequisiti

Prima di completare questa esercitazione, assicurarsi che l'area di lavoro di Azure Databricks e l'ambiente di sviluppo locale siano configurati correttamente. Vedere Configurare l'area di lavoro e l'ambiente di sviluppo di Databricks Apps.

Passaggio 1: Installare le dipendenze

Aprire un terminale ed eseguire i comandi seguenti per:

  • Installare le librerie Python richieste dall'app di esempio.
  • Creare una directory locale per i file di origine e configurazione per l'app.
pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world è la directory locale per i file dell'app.

Passaggio 2: Creare l'app

  1. Nell'area di lavoro di Databricks fare clic su + Nuova>app nella barra laterale sinistra.

  2. Scegliere il modello Gradio Hello world .

    Selezionare il modello Hello World

  3. Assegnare all'app il nome gradio-hello-world e fare clic su Installa.

Verrà creata una nuova app in base al modello selezionato e la distribuisce nell'area di lavoro.

Passaggio 3: Visualizzare l'app

Dopo aver creato un'app, viene avviata automaticamente e viene visualizzato un URL che è possibile usare per visualizzarne l'anteprima. Visualizzare l'URL dell'app e lo stato della distribuzione nella pagina Panoramica :

Visualizzare la pagina dei dettagli dell'app dopo la distribuzione dell'app

Fare clic sull'URL per visualizzare l'app:

Visualizzare l'output dell'app hello world in locale

Azure Databricks genera automaticamente l'URL dell'app in base al nome dell'app e all'ID dell'area di lavoro. Non è possibile modificare l'URL dopo aver creato l'app. Se è necessario un URL diverso, creare una nuova app con un nome diverso. Per altre informazioni, vedere URL dell'app.

Passaggio 4: Copiare l'app nel computer

Dopo aver creato l'app, è possibile scaricare il codice sorgente nel computer locale per personalizzarlo.

  1. Copiare i comandi in Sincronizzare i file:

    Visualizzare la pagina dei dettagli dell'app dopo la creazione dell'app

  2. In un terminale passare alla gradio-hello-world directory locale creata, quindi eseguire i comandi copiati:

    databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app .

...
Export complete

gradio-hello-world % databricks sync --watch . /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app

...
Initial Sync Complete

    Il primo comando esporta tre file dall'area di lavoro nella directory locale: app.py, app.yamle requirements.txt. Il secondo comando avvia un processo di sincronizzazione che controlla le modifiche dei file locali e le carica automaticamente nell'area di lavoro.

    • app.py contiene il codice che implementa la funzionalità e l'interfaccia utente dell'app.
    • app.yaml definisce la configurazione dell'app, inclusi il punto di ingresso e le autorizzazioni.
    • requirements.txt elenca i pacchetti Python richiesti dall'app.

Passaggio 5: Modificare e testare l'app in locale

  1. Facoltativamente, personalizzare e sviluppare l'app in locale. Ad esempio, è possibile modificare app.py per rendere interattivi i dati, aggiungere un tema o applicare stili o consentire il caricamento dei dati.

  2. Per testare l'app, eseguire python app.py:

    python app.py

Running on local URL:  http://127.0.0.1:7860
...

  3. Per visualizzare l'app, passare a http://127.0.0.1:7860 in una finestra del browser.

  4. In modo facoltativo, usare il comando run-local delle app Databricks per eseguire e fare il debug dell'app:

    databricks apps run-local --prepare-environment --debug

    Questo comando installa tutte le dipendenze e prepara l'ambiente virtuale, quindi avvia l'app e il debugger sulla porta 5678. Passare a http://localhost:8001 per visualizzare l'app.

    Per impostare i punti di interruzione in Visual Studio Code, installare l'estensione del debugger Python, quindi passare a Esegui>Avvia il debug>Collegamento Remoto.

Passaggio 6: Distribuire nuovamente l'app nell'area di lavoro

Per distribuire nuovamente l'app, copiare il comando sotto Deploy to Databricks Apps nella pagina della panoramica dell'app:

Copiare il comando per distribuire un'app

Eseguire il comando dall'interno della gradio-hello-world directory locale.

Il comando ha esito positivo con:

{
  "create_time": "2026-02-03T23:25:38Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/4cfd4a36-2cef-4155-88c4-d258ed6d0d91/src/01f10157a60a113e980014bebd5f4a03"
  },
  "deployment_id": "01f10157a60a113e980014bebd5f4a03",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2026-02-03T23:25:41Z"
}

Per visualizzare lo stato della distribuzione, passare alla pagina Panoramica per l'app.

Passaggi successivi

Dopo aver distribuito e personalizzato la prima app, è possibile:

  • Last updated on