本文可協助您使用逐步範例開始使用 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:建立應用程式
在您的 Databricks 工作區中,按下左側邊欄中的 + 新增>應用程式。
選擇 Gradio Hello 世界 範本。
將應用程式命名為 gradio-hello-world ,然後按兩下 [ 安裝]。
這會根據選取的範本建立新的應用程式,並將其部署至您的工作區。
步驟 3:檢視應用程式
建立應用程式之後,它會自動啟動,並顯示可用來預覽它的URL。 在 [概 觀 ] 頁面上檢視應用程式 URL 和部署狀態:
點選 URL 以檢視應用程式:
Azure Databricks 會根據您的應用程式名稱和工作區識別碼自動產生應用程式 URL。 建立應用程式後,您無法變更 URL。 如果您需要不同的 URL,請使用不同的名稱建立新的應用程式。 如需詳細資訊,請參閱 應用程式 URL。
步驟 4:將應用程式複製到您的電腦
建立應用程式之後,您可以將原始碼下載到本機計算機以自定義它。
複製「 同步檔案」下的指令:
在終端機中,導覽到
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:在本機修改及測試應用程式
您可以選擇性地在本機自定義及開發您的應用程式。 例如,您可以修改
app.py以讓數據成為互動式數據、新增主題或樣式選項,或允許數據上傳。若要測試您的應用程式,請執行
python app.py:python app.py Running on local URL: http://127.0.0.1:7860 ...若要檢視應用程式,請在瀏覽器視窗中瀏覽至
http://127.0.0.1:7860。或者,使用 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"
}
若要檢視部署狀態,請移至應用程式的 [概 觀 ] 頁面。
下一步
現在您已部署並自定義第一個應用程式,您可以: