Kom igång med Databricks-appar

Den här sidan hjälper dig att komma igång med Databricks-appar med hjälp av ett steg för steg-exempel för att skapa en enkel app på din Azure Databricks arbetsyta med hjälp av en mall som följer Azure Databricks bästa praxis.

Det här exemplet vägleder dig genom:

• Skapa en app från en mall
• Visa appen när den har driftsatts
• Kopiera appmallen till datorn för vidare utveckling
• Köra appen lokalt
• Återdistribuera appen på din arbetsyta

I slutet av den här artikeln kommer du att kunna iterera i din app lokalt och distribuera uppdateringar till Databricks.

Förutsättningar

Innan du slutför den här självstudien kontrollerar du att din Azure Databricks arbetsyta och lokala utvecklingsmiljö är korrekt konfigurerade. Se Konfigurera din Databricks Apps-arbetsyta och utvecklingsmiljö.

Steg 1: Installera beroenden

Öppna en terminal och kör följande kommandon för att:

• Installera de Python bibliotek som krävs av exempelappen.
• Skapa en lokal katalog för käll- och konfigurationsfilerna för din app.

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

gradio-hello-world är den lokala katalogen för dina appfiler.

Steg 2: Skapa appen

1. I databricks-arbetsytan klickar du på appväxlare och väljer Databricks-appar.

2. Klicka på + Skapa app.

3. Välj mallen Gradio Hello World.

   

4. Ge appen namnet gradio-hello-world och klicka på Skapa app.

Detta skapar en ny app baserat på den valda mallen och distribuerar den till din arbetsyta.

Steg 3: Visa appen

När du har skapat en app startar den automatiskt och visar en URL som du kan använda för att förhandsgranska den. Visa appens URL och distributionsstatus på sidan Översikt :

Klicka på URL:en för att visa appen:

Azure Databricks genererar appens URL automatiskt baserat på appens namn och arbetsyte-ID. Du kan inte ändra URL:en när du har skapat appen. Om du behöver en annan URL skapar du en ny app med ett annat namn. Mer information finns i App-URL.

Steg 4: Kopiera appen till datorn

När du har skapat appen kan du ladda ned källkoden till den lokala datorn för att anpassa den.

1. Kopiera kommandona under Redigera i din IDE:

   

2. I en terminal går du till den gradio-hello-world lokala katalogen som du skapade och kör sedan de kopierade kommandona:

   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
   

   Det första kommandot exporterar tre filer från arbetsytan till din lokala katalog: app.py, app.yamloch requirements.txt. Det andra kommandot startar en synkroniseringsprocess som bevakar lokala filändringar och automatiskt laddar upp dem till din arbetsyta.

   • app.py innehåller koden som implementerar appens funktioner och användargränssnitt.
   • app.yaml definierar appens konfiguration, inklusive dess startpunkt och behörigheter.
   • requirements.txt visar de Python paket som krävs av appen.

Steg 5: Ändra och testa appen lokalt

1. Du kan också anpassa och utveckla din app lokalt. Du kan till exempel ändra app.py för att göra data interaktiva, lägga till ett tema eller formateringsalternativ eller tillåta datauppladdningar.

2. Testa din app genom att köra python app.py:

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

3. Om du vill visa appen navigerar du till http://127.0.0.1:7860 i ett webbläsarfönster.

4. Du kan också använda kommandot databricks apps run-local för att köra och felsöka appen:

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

   Det här kommandot installerar alla beroenden och förbereder den virtuella miljön och startar sedan appen och felsökningsprogrammet på port 5678. Gå till http://localhost:8001 för att visa appen.

   Om du vill ange brytpunkter i Visual Studio Code installerar du tillägget Python felsökningsprogram och går sedan till Run>Start Debugging>Remote Attach.

Steg 6: Distribuera om appen till din arbetsyta

Om du vill distribuera om appen kopierar du kommandot under Distribuera till Databricks-appar på appöversiktssidan:

Kör kommandot inifrån den gradio-hello-world lokala katalogen.

Kommandot lyckas med:

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

Om du vill visa distributionsstatus går du till sidan Översikt för appen.

Steg 7 (valfritt): Distribuera från en Git-lagringsplats

I föregående steg används synkronisering av arbetsytor för att distribuera din app. Om du vill ha ett mer skalbart arbetsflöde skickar du din appkod till en Git-lagringsplats och distribuerar därifrån. På så sätt kan du använda versionskontroll, samarbeta med teammedlemmar och eventuellt distribuera automatiskt vid varje push-överföring.

1. Initiera en Git-lagringsplats i din gradio-hello-world katalog och skicka den till din Git-provider (till exempel GitHub):

   git init
   git add .
   git commit -m "Initial app code"
   git remote add origin https://github.com/your-org/gradio-hello-world
   git push -u origin main
   

2. Konfigurera Git-lagringsplatsen i din app:

   databricks apps create-update gradio-hello-world \
      --json '{"update_mask": "git_repository", "git_repository": {"url": "https://github.com/your-org/gradio-hello-world", "provider": "gitHub"}}'
   

3. För privata lagringsplatser lägger du till en Git-autentiseringsuppgift för appens tjänsthuvudnamn. Se CLI-instruktionerna i Distribuera från en Git-lagringsplats.

4. Distribuera från Git:

   databricks apps deploy gradio-hello-world \
      --json '{"git_source": {"branch": "main"}}'
   

När du har konfigurerat Git-distributionen kan du distribuera om genom att skicka till lagringsplatsen och köra kommandot deploy igen. Om du vill distribuera om automatiskt vid varje push-överföring aktiverar du automatiska Git-distributioner. Se Aktivera automatiska Git-distributioner (Beta).

Ytterligare resurser

Nu när du har distribuerat och anpassat din första app kan du:

• Distribuera från en Git-lagringsplats för att hantera din appkod med versionskontroll.
• Aktivera automatiska Git-distributioner för att distribuera om din app vid varje push-överföring till en gren.
• Konfigurera CI/CD med GitHub Actions för arbetsflöden för produktionsdistribution med verifierings- och hälsokontroller.
• Konfigurera auktorisering för att hantera vem som kan komma åt och redigera din app.
• Integrera din app med Azure Databricks plattformsfunktioner som Azure Databricks hemligheter eller Databricks SQL.
• Dela din app med andra användare på din arbetsyta eller i hela organisationen.
• Utforska fler appmallar för att experimentera med olika ramverk och funktioner.