共用方式為


開始使用 Databricks Apps

本文可協助您使用逐步範例開始使用 Databricks Apps,以使用遵循 Azure Databricks 最佳做法的範本,在 Azure Databricks 工作區中建立簡單的應用程式。

此範例會逐步引導您:

  • 從範本建立應用程式
  • 應用程式部署完成後查看應用程式
  • 將應用程式範本複製到您的電腦以進一步開發
  • 在本機執行應用程式
  • 將應用程式重新部署至工作區

在本文結束時,您將能夠在本地對您的應用程式進行迭代,並將更新部署到 Databricks。

先決條件

完成本教學課程之前,請確定您的 Azure Databricks 工作區和本機開發環境已正確設定。 請參閱 設定 Databricks Apps 工作區和開發環境

步驟 1:安裝依賴項

開啟終端機,然後執行下列命令以:

  • 安裝範例應用程式所需的 Python 連結庫。
  • 為應用程式的來源和組態檔建立本機目錄。
pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world 是應用程式檔案的本機目錄。

步驟 2:建立應用程式

  1. 在您的 Databricks 工作區中,按下左側邊欄中的 + 新增>應用程式

  2. 選擇 Gradio Hello 世界 範本。

    選取 Hello World 範本

  3. 將應用程式命名為 gradio-hello-world ,然後按兩下 [ 安裝]。

這會根據選取的範本建立新的應用程式,並將其部署至您的工作區。

步驟 3:檢視應用程式

建立應用程式之後,它會自動啟動,並顯示可用來預覽它的URL。 在 [概 ] 頁面上檢視應用程式 URL 和部署狀態:

在應用程式部署之後檢視應用程式詳細數據頁面

點選 URL 以檢視應用程式:

在本機檢視 hello world 應用程式的輸出

Azure Databricks 會根據您的應用程式名稱和工作區識別碼自動產生應用程式 URL。 建立應用程式後,您無法變更 URL。 如果您需要不同的 URL,請使用不同的名稱建立新的應用程式。 如需詳細資訊,請參閱 應用程式 URL

步驟 4:將應用程式複製到您的電腦

建立應用程式之後,您可以將原始碼下載到本機計算機以自定義它。

  1. 複製「 同步檔案」下的指令:

    在應用程式建立之後檢視應用程式詳細數據頁面

  2. 在終端機中,導覽到 gradio-hello-world 你建立的本地目錄,然後執行複製的指令:

    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
    

    第一個指令會將三個檔案從工作區匯出到本地目錄:app.py、、 app.yamlrequirements.txt和 。 第二個指令啟動同步程序,監控本地檔案變更並自動上傳到你的工作區。

    • app.py 包含實作應用程式功能與使用者介面的程式碼。
    • app.yaml 定義應用程式的設定,包括入口點與權限。
    • requirements.txt 列出應用程式所需的 Python 套件。

步驟 5:在本機修改及測試應用程式

  1. 您可以選擇性地在本機自定義及開發您的應用程式。 例如,您可以修改 app.py 以讓數據成為互動式數據、新增主題或樣式選項,或允許數據上傳。

  2. 若要測試您的應用程式,請執行 python app.py

    python app.py
    
    Running on local URL:  http://127.0.0.1:7860
    ...
    
  3. 若要檢視應用程式,請在瀏覽器視窗中瀏覽至 http://127.0.0.1:7860

  4. 或者,使用 databricks 應用程式 run-local 命令 來執行和偵錯應用程式。

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

    此命令會安裝所有相依性並準備虛擬環境,然後在埠 5678 上啟動應用程式和調試程式。 流覽至 http://localhost:8001 以檢視應用程式。

    若要在 Visual Studio Code 中設定斷點,請安裝 Python 偵錯器擴充功能,然後移至 執行>開始偵錯>遠端附加

步驟 6:將應用程式重新部署至工作區

若要重新部署應用程式,請在應用程式總覽頁面複製 「部署到 Databricks 應用程式 」下的指令:

複製 命令以部署應用程式

從本機目錄內 gradio-hello-world 執行 命令。

命令成功執行:

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

若要檢視部署狀態,請移至應用程式的 [概 ] 頁面。

下一步

現在您已部署並自定義第一個應用程式,您可以:

  • 設定授權 來管理誰可以存取和編輯您的應用程式。
  • 整合您的應用程式 與 Azure Databricks 平臺功能,例如 Azure Databricks 秘密或 Databricks SQL。
  • 在工作區或整個組織中與其他用戶共用您的應用程式
  • 探索更多應用程式範本,以試驗不同的架構和功能。