Erste Schritte mit Databricks-Apps

Dieser Artikel hilft Ihnen bei den ersten Schritten mit Databricks-Apps mithilfe eines Schritt-für-Schritt-Beispiels zum Erstellen einer einfachen App in Ihrem Azure Databricks-Arbeitsbereich mithilfe einer Vorlage, die den bewährten Methoden von Azure Databricks folgt.

Dieses Beispiel führt Sie durch:

• Erstellen einer App aus einer Vorlage
• Betrachten der App nach der Bereitstellung
• Kopieren der App-Vorlage auf Ihren Computer zur Weiteren Entwicklung
• Lokales Ausführen der App
• Erneutes Bereitstellen der App in Ihrem Arbeitsbereich

Bis zum Ende dieses Artikels werden Sie in der Lage sein, Ihre App lokal weiterzuentwickeln und Updates für Databricks bereitzustellen.

Voraussetzungen

Bevor Sie dieses Lernprogramm abschließen, stellen Sie sicher, dass Ihr Azure Databricks-Arbeitsbereich und ihre lokale Entwicklungsumgebung ordnungsgemäß konfiguriert sind. Weitere Informationen finden Sie unter Einrichten ihres Databricks-Apps-Arbeitsbereichs und ihrer Entwicklungsumgebung.

Schritt 1: Installieren von Abhängigkeiten

Öffnen Sie ein Terminal, und führen Sie die folgenden Befehle aus:

• Installieren Sie die python-Bibliotheken, die von der Beispiel-App benötigt werden.
• Erstellen Sie ein lokales Verzeichnis für die Quell- und Konfigurationsdateien für Ihre App.

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

gradio-hello-world ist das lokale Verzeichnis für Ihre App-Dateien.

Schritt 2: Erstellen der App

1. Klicken Sie in Ihrem Databricks-Arbeitsbereich in der linken Randleiste auf +Neue>App .

2. Wechseln Sie unter Von einer Vorlage installieren zur Registerkarte Gradio.

3. Wählen Sie die Vorlage "Hello world " aus.

   

4. Benennen Sie die App gradio-hello-world , und klicken Sie auf "Installieren".

Dadurch wird eine neue App basierend auf der ausgewählten Vorlage erstellt und in Ihrem Arbeitsbereich bereitgestellt.

Schritt 3: Anzeigen der App

Nachdem Sie eine App erstellt haben, wird sie automatisch gestartet und zeigt eine URL an, mit der Sie eine Vorschau anzeigen können. Anzeigen der App-URL und des Bereitstellungsstatus auf der Seite "Übersicht ":

Klicken Sie auf die URL, um die App anzuzeigen:

Azure Databricks generiert die App-URL automatisch basierend auf Ihrem App-Namen und Ihrer Arbeitsbereichs-ID. Sie können die URL nach dem Erstellen der App nicht mehr ändern. Wenn Sie eine andere URL benötigen, erstellen Sie eine neue App mit einem anderen Namen. Weitere Informationen finden Sie unter App-URL.

Schritt 4: Kopieren der App auf Ihren Computer

Nachdem Sie die App erstellt haben, können Sie den Quellcode auf Ihren lokalen Computer herunterladen, um sie anzupassen.

1. Kopieren Sie den ersten Befehl unter "Dateien synchronisieren":

   

2. Navigieren Sie in einem Terminal zu dem gradio-hello-world von Ihnen erstellten lokalen Verzeichnis, und führen Sie dann den kopierten Befehl aus.

   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
   

   Der Befehl kopiert zwei neue Dateien in das Verzeichnis namens app.py und app.yaml. app.yaml definiert die Konfiguration der App, einschließlich des Einstiegspunkts und der Berechtigungen. app.py enthält den Code, der die Funktionalität und Benutzeroberfläche der App implementiert.

Schritt 5: Lokales Ändern und Testen der App

1. Optional können Sie Ihre App lokal anpassen und entwickeln. Sie können beispielsweise ändern app.py , um die Daten interaktiv zu machen, ein Design oder formatierungsoptionen hinzuzufügen oder Datenuploads zuzulassen.

2. Um Ihre App zu testen, führen Sie Folgendes aus python app.py:

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

3. Um die App anzuzeigen, navigieren Sie zu http://127.0.0.1:7860 in einem Browserfenster.

4. Optional können Sie den databricks apps run-local Befehl verwenden, um die Anwendung auszuführen und zu debuggen:

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

   Dieser Befehl installiert alle Abhängigkeiten und bereitet die virtuelle Umgebung vor, startet dann die App und den Debugger auf Port 5678. Navigieren Sie zu http://localhost:8001, um die App anzusehen.

   Um Breakpoints in Visual Studio Code festzulegen, installieren Sie die Python-Debugger-Erweiterung und wechseln Sie dann zu Ausführen>Debugging starten>Remote-Verbinden.

Schritt 6: Erneutes Bereitstellen der App in Ihrem Arbeitsbereich

Um die App erneut bereitzustellen, kopieren Sie den Befehl unter "In Databricks-Apps bereitstellen" auf der App-Detailseite:

Führen Sie den Befehl aus dem gradio-hello-world lokalen Verzeichnis aus.

Der Befehl wurde erfolgreich ausgeführt mit

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

Um den Bereitstellungsstatus anzuzeigen, wechseln Sie zur Seite "Übersicht" für die App.

Nächste Schritte

Nachdem Sie Ihre erste App bereitgestellt und angepasst haben, haben Sie folgende Möglichkeiten:

• Konfigurieren Sie die Autorisierung , um zu verwalten, wer auf Ihre App zugreifen und sie bearbeiten kann.
• Integrieren Sie Ihre App in Azure Databricks-Plattformfeatures wie Azure Databricks secrets oder Databricks SQL.
• Geben Sie Ihre App für andere Benutzer in Ihrem Arbeitsbereich oder in Ihrer gesamten Organisation frei.
• Erkunden Sie weitere App-Vorlagen, um mit verschiedenen Frameworks und Funktionen zu experimentieren.