Wprowadzenie do usługi Databricks Apps

Ten artykuł ułatwia rozpoczęcie pracy z usługą Databricks Apps przy użyciu przykładu krok po kroku w celu utworzenia prostej aplikacji w obszarze roboczym usługi Azure Databricks przy użyciu szablonu zgodnego z najlepszymi rozwiązaniami usługi Azure Databricks.

W tym przykładzie przedstawiono następujące kroki:

• Tworzenie aplikacji na podstawie szablonu
• Wyświetlanie aplikacji po jej wdrożeniu
• Kopiowanie szablonu aplikacji na komputer w celu dalszego programowania
• Uruchamianie aplikacji lokalnie
• Ponowne wdrażanie aplikacji w obszarze roboczym

Po zakończeniu tego artykułu będziesz mieć możliwość przeprowadzenia iteracji na swoim komputerze lokalnym i wdrażania aktualizacji na platformie Databricks.

Wymagania wstępne

Przed ukończeniem tego samouczka upewnij się, że obszar roboczy usługi Azure Databricks i lokalne środowisko programistyczne są poprawnie skonfigurowane. Zobacz Konfigurowanie obszaru roboczego usługi Databricks Apps i środowiska programistycznego.

Krok 1. Instalowanie zależności

Otwórz terminal i uruchom następujące polecenia, aby:

• Zainstaluj biblioteki Pythona wymagane przez przykładową aplikację.
• Utwórz katalog lokalny dla plików źródłowych i konfiguracyjnych aplikacji.

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

gradio-hello-world to katalog lokalny dla plików aplikacji.

Krok 2. Tworzenie aplikacji

1. W obszarze roboczym usługi Databricks kliknij pozycję + Nowa>aplikacja na pasku bocznym po lewej stronie.

2. Wybierz szablon Gradio Hello world .

   

3. Nadaj aplikacji nazwę gradio-hello-world i kliknij przycisk Zainstaluj.

Spowoduje to utworzenie nowej aplikacji na podstawie wybranego szablonu i wdrożenie jej w obszarze roboczym.

Krok 3. Wyświetlanie aplikacji

Po utworzeniu aplikacji zostanie ona uruchomiona automatycznie i zostanie wyświetlony adres URL, którego można użyć do wyświetlenia podglądu. Wyświetl adres URL aplikacji i stan wdrożenia na stronie Przegląd :

Kliknij adres URL, aby wyświetlić aplikację:

Usługa Azure Databricks automatycznie generuje adres URL aplikacji na podstawie nazwy aplikacji i identyfikatora obszaru roboczego. Nie można zmienić adresu URL po utworzeniu aplikacji. Jeśli potrzebujesz innego adresu URL, utwórz nową aplikację o innej nazwie. Aby uzyskać więcej informacji, zobacz Adres URL aplikacji.

Krok 4. Kopiowanie aplikacji na komputer

Po utworzeniu aplikacji możesz pobrać kod źródłowy na komputer lokalny, aby go dostosować.

1. Skopiuj polecenia w obszarze Synchronizuj pliki:

   

2. W terminalu przejdź do utworzonego katalogu lokalnego gradio-hello-world , a następnie uruchom skopiowane polecenia:

   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
   

   Pierwsze polecenie eksportuje trzy pliki z obszaru roboczego do katalogu lokalnego: app.py, app.yamli requirements.txt. Drugie polecenie uruchamia proces synchronizacji, który obserwuje zmiany pliku lokalnego i automatycznie przekazuje je do obszaru roboczego.

   • app.py zawiera kod, który implementuje funkcje aplikacji i interfejs użytkownika.
   • app.yaml definiuje konfigurację aplikacji, w tym jej punkt wejścia i uprawnienia.
   • requirements.txt wyświetla listę pakietów języka Python wymaganych przez aplikację.

Krok 5. Modyfikowanie i testowanie aplikacji lokalnie

1. Opcjonalnie dostosuj i opracuj aplikację lokalnie. Można na przykład zmodyfikować app.py dane tak, aby były interaktywne, dodawać motyw lub opcje stylów albo zezwalać na przekazywanie danych.

2. Aby przetestować aplikację, uruchom polecenie python app.py:

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

3. Aby wyświetlić aplikację, przejdź do http://127.0.0.1:7860 w oknie przeglądarki.

4. Opcjonalnie użyj polecenia databricks apps run-local, aby uruchomić i debugować aplikację:

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

   To polecenie instaluje wszystkie zależności i przygotowuje środowisko wirtualne, a następnie uruchamia aplikację i debuger na porcie 5678. Przejdź do http://localhost:8001, aby wyświetlić aplikację.

   Aby ustawić punkty przerwania w programie Visual Studio Code, zainstaluj rozszerzenie debuggera Pythona, a następnie przejdź do Uruchom>Rozpocznij Debugowanie>Zdalne Przystawianie.

Krok 6. Ponowne wdrożenie aplikacji w obszarze roboczym

Aby ponownie wdrożyć aplikację, skopiuj polecenie w obszarze Wdrażanie do aplikacji Databricks na stronie przeglądu aplikacji.

Uruchom polecenie z poziomu katalogu lokalnego gradio-hello-world .

Polecenie wykonuje się pomyślnie z:

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

Aby wyświetlić stan wdrożenia, przejdź do strony Przegląd aplikacji.

Następne kroki

Po wdrożeniu i dostosowaniu pierwszej aplikacji możesz:

• Skonfiguruj autoryzację , aby zarządzać osobami, które mogą uzyskiwać dostęp do aplikacji i edytować je.
• Integruj swoją aplikację z funkcjami platformy Azure Databricks, takimi jak sekrety Azure Databricks lub Databricks SQL.
• Udostępnij aplikację innym użytkownikom w obszarze roboczym lub w całej organizacji.
• Poznaj więcej szablonów aplikacji, aby eksperymentować z różnymi strukturami i możliwościami.