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. Sotto Installa da un modello, vai alla scheda Gradio.

  3. Scegliere il modello Hello world .

    Selezionare il modello Hello World

  4. 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 il primo comando in Sincronizzare i file:

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

  2. In un terminale, spostarsi nella directory locale gradio-hello-world che hai creato, quindi eseguire il comando copiato.

    databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app .

...
Export complete

    Il comando copia due nuovi file nella directory denominata app.py e app.yaml. app.yaml definisce la configurazione dell'app, inclusi il punto di ingresso e le autorizzazioni. app.py contiene il codice che implementa la funzionalità e l'interfaccia utente dell'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 Distribuisci nelle app Databricks nella pagina dei dettagli dell'applicazione.

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": "2025-06-09T19:36:50Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/1234abcd-5678-90ab-cdef-123456abcdef/src/abcd1234efgh5678ijkl9012mnop3456"
  },
  "deployment_id": "abcd1234efgh5678ijkl9012mnop3456",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2025-06-09T19:36:51Z"
}

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