Aan de slag met Databricks-apps

Dit artikel helpt u aan de slag te gaan met Databricks-apps met behulp van een stapsgewijs voorbeeld om een eenvoudige app te maken in uw Azure Databricks-werkruimte met behulp van een sjabloon die de aanbevolen procedures van Azure Databricks volgt.

In dit voorbeeld wordt u begeleid bij het volgende:

• Een app maken op basis van een sjabloon
• De app weergeven nadat deze is geïmplementeerd
• De app-sjabloon naar uw computer kopiëren voor verdere ontwikkeling
• De app lokaal uitvoeren
• De app opnieuw implementeren in uw werkruimte

Aan het einde van dit artikel kunt u uw app lokaal itereren en updates implementeren in Databricks.

Vereiste voorwaarden

Voordat u deze zelfstudie voltooit, moet u ervoor zorgen dat uw Azure Databricks-werkruimte en lokale ontwikkelomgeving correct zijn geconfigureerd. Zie Uw Databricks Apps-werkruimte en -ontwikkelomgeving instellen.

Stap 1: Afhankelijkheden installeren

Open een terminal en voer de volgende opdrachten uit om:

• Installeer de Python-bibliotheken die zijn vereist voor de voorbeeld-app.
• Maak een lokale map voor de bron- en configuratiebestanden voor uw app.

pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world is de lokale map voor uw app-bestanden.

Stap 2: De app maken

1. Klik in uw Databricks-werkruimte op + Nieuwe>app in de linkerzijbalk.

2. Kies de Gradio Hello world-sjabloon .

   

3. Noem de app gradio-hello-world en klik op Installeren.

Hiermee maakt u een nieuwe app op basis van de geselecteerde sjabloon en implementeert u deze in uw werkruimte.

Stap 3: de app weergeven

Nadat u een app hebt gemaakt, wordt deze automatisch gestart en wordt een URL weergegeven die u kunt gebruiken om een voorbeeld van de app te bekijken. Bekijk de URL en de implementatiestatus van de app op de pagina Overzicht :

Klik op de URL om de app weer te geven:

Azure Databricks genereert automatisch de app-URL op basis van de naam en werkruimte-id van uw app. U kunt de URL niet wijzigen nadat u de app hebt gemaakt. Als u een andere URL nodig hebt, maakt u een nieuwe app met een andere naam. Zie app-URL voor meer informatie.

Stap 4: De app naar uw computer kopiëren

Nadat u de app hebt gemaakt, kunt u de broncode downloaden naar uw lokale computer om deze aan te passen.

1. Kopieer de opdrachten onder De bestanden synchroniseren:

   

2. Navigeer in een terminal naar de gradio-hello-world lokale map die u hebt gemaakt en voer vervolgens de gekopieerde opdrachten uit:

   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
   

   Met de eerste opdracht exporteert u drie bestanden van uw werkruimte naar uw lokale map: app.py, app.yamlen requirements.txt. Met de tweede opdracht wordt een synchronisatieproces gestart dat controleert op wijzigingen in lokale bestanden en deze automatisch uploadt naar uw werkruimte.

   • app.py bevat de code waarmee de functionaliteit en gebruikersinterface van de app worden geïmplementeerd.
   • app.yaml definieert de configuratie van de app, inclusief het toegangspunt en de machtigingen.
   • requirements.txt vermeldt de Python-pakketten die vereist zijn voor de app.

Stap 5: de app lokaal wijzigen en testen

1. U kunt uw app desgewenst lokaal aanpassen en ontwikkelen. U kunt bijvoorbeeld wijzigen app.py om de gegevens interactief te maken, een thema of stijlopties toe te voegen of het uploaden van gegevens toe te staan.

2. Voer het volgende uit python app.pyom uw app te testen:

   python app.py
   
   Running on local URL:  http://127.0.0.1:7860
   ...
   

3. Als u de app wilt weergeven, gaat u naar http://127.0.0.1:7860 in een browservenster.

4. Gebruik desgewenst de databricks apps run-local command om de app uit te voeren en te debuggen:

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

   Met deze opdracht worden alle afhankelijkheden geïnstalleerd en de virtuele omgeving voorbereid, waarna de app en het foutopsporingsprogramma op poort 5678 worden gestart. Navigeer naar http://localhost:8001 om de app te bekijken.

   Als u onderbrekingspunten wilt instellen in Visual Studio Code, installeert u de extensie python-foutopsporingsprogramma en gaat u vervolgens naar Start>Debugging>Remote Attach uitvoeren.

Stap 6: De app opnieuw implementeren in uw werkruimte

Als u de app opnieuw wilt implementeren, kopieert u de opdracht onder Implementeren naar Databricks-apps op de overzichtspagina van de app:

Voer de opdracht uit vanuit de gradio-hello-world lokale map.

De opdracht slaagt met:

{
  "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"
}

Als u de implementatiestatus wilt weergeven, gaat u naar de pagina Overzicht voor de app.

Volgende stappen

Nu u uw eerste app hebt geïmplementeerd en aangepast, kunt u het volgende doen:

• Configureer autorisatie om te beheren wie toegang heeft tot uw app en deze kan bewerken.
• Integreer uw app met Azure Databricks-platformfuncties zoals Azure Databricks-geheimen of Databricks SQL.
• Deel uw app met andere gebruikers in uw werkruimte of in uw organisatie.
• Verken meer app-sjablonen om te experimenteren met verschillende frameworks en mogelijkheden.