Databricks 应用入门

本页通过分步示例帮助你开始使用 Databricks Apps，以使用遵循Azure Databricks最佳做法的模板在Azure Databricks工作区中创建一个简单的应用。

此示例将带领你：

  • 从模板创建应用
  • 部署应用后查看应用
  • 将应用模板复制到计算机以进一步开发
  • 在本地运行应用
  • 将应用重新部署到工作区

本文结束时，你将能够在本地迭代您的应用程序，并将更新部署到 Databricks。

Tip

如果要从 Git 存储库而不是工作区同步进行部署，请跳过模板，并使用创建过程中配置的 Git 存储库 创建自定义应用 。 然后，请参阅 从 Git 存储库进行部署 。

先决条件

在完成本教程之前，请确保正确配置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 工作区中，单击 “应用”图标。 应用切换器并选择 Databricks Apps。

  2. 单击“ + 创建应用”。

  3. 选择 Gradio Hello world 模板。

    选择Hello World模板

  4. 将应用 命名为 app gradio-hello-world ，然后单击“ 创建应用”。

这会基于所选模板创建新应用，并将其部署到工作区。

步骤 3：查看应用

创建应用后，它会自动启动，并显示可用于预览它的 URL。 在 “概述 ”页上查看应用 URL 和部署状态：

在应用部署后查看应用详细信息页

单击 URL 以查看应用：

在本地查看 hello world 应用的输出

Azure Databricks会根据应用名称和工作区 ID 自动生成应用 URL。 创建应用后，无法更改 URL。 如果需要其他 URL，请创建具有不同名称的新应用。 有关详细信息，请参阅 应用 URL。

步骤 4：将应用复制到计算机

创建应用后，可以将源代码下载到本地计算机以对其进行自定义。

  1. 在 IDE 中复制“ 编辑”下的命令：

    创建应用后查看应用详细信息页

  2. 在终端中，导航到你创建的gradio-hello-world 本地目录，然后运行复制的命令：

    databricks workspace export-dir /Workspace/Users/[email protected]/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app .

...
Export complete

gradio-hello-world % databricks sync --watch . /Workspace/Users/[email protected]/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app

...
Initial Sync Complete

    第一个命令将三个文件从工作区导出到本地目录： app.py， app.yaml以及 requirements.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 应用运行本地命令 来运行和调试应用：

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

    此命令安装所有依赖项并准备虚拟环境，然后在端口 5678 上启动应用和调试器。 导航到 http://localhost:8001 查看应用。

    若要在 Visual Studio Code 中设置断点，请安装Python调试器扩展，然后转到 Run>start Debugging>Remote Attach。

步骤 6：将应用重新部署到工作区

若要重新部署应用，请在应用概述页上的 “部署到 Databricks 应用 ”下复制命令：

复制命令以部署应用

从 gradio-hello-world 本地目录中运行命令。

该命令成功，

{
  "create_time": "2026-02-03T23:25:38Z",
  "creator": "[email protected]",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/4cfd4a36-2cef-4155-88c4-d258ed6d0d91/src/01f10157a60a113e980014bebd5f4a03"
  },
  "deployment_id": "01f10157a60a113e980014bebd5f4a03",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/[email protected]/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"
}

若要查看部署状态，请转到应用的 “概述 ”页。

步骤 7 （可选）：从 Git 存储库部署

前面的步骤使用工作区同步来部署应用。 对于可缩放的工作流，请将应用代码推送到 Git 存储库并从那里部署。 这样，便可以使用版本控制、与团队成员协作，还可以选择在每个推送上自动部署。

  1. 在你的 gradio-hello-world 目录中初始化 Git 存储库，并将其推送到你的 Git 提供商（例如 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. 在应用中配置 Git 存储库：

    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. 对于专用存储库，请为应用的服务主体添加 Git 凭据。 请参阅 从 Git 存储库部署中的 CLI 说明。

  4. 从 Git 部署：

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

配置 Git 部署后，可以通过推送到存储库并再次运行部署命令来重新部署。 若要在每次推送时自动重新部署，请启用 Git 自动部署。 请参阅 “启用自动 Git 部署”（Beta）。

其他资源

部署并自定义第一个应用后，可以：

  • Last updated on