本文包含有关主要 Databricks 资产捆绑包 功能和变更的详细说明。 捆绑功能随 Databricks CLI 一起发布。
有关更新的完整列表，请参阅 Databricks CLI GitHub 存储库发行说明。
小窍门
若要收到 Databricks CLI 和捆绑功能的新版本的通知，请为 CLI 存储库配置 GitHub 通知。 请参阅 关于 GitHub 通知。
工作区中的组件目前为公共预览版
2025 年 5 月 19 日
此功能随 Databricks CLI 0.250.0 一起发布。
现在，使用工作区中的捆绑包可以更轻松地与组织中的其他用户协作处理 Databricks 资产捆绑包，这样工作区用户就可以通过 UI 编辑、提交、测试和部署捆绑包更新。
请参阅 在工作区中协作处理捆绑包。
内联脚本执行支持
2025 年 4 月 30 日
此功能随 Databricks CLI 0.250.0 一起发布。
现在可以使用命令在与捆绑包 databricks bundle run 相同的身份验证上下文中运行脚本。 请参阅运行作业或管道。
用于 Databricks 资产捆绑包的 Python 为公共预览版
2025 年 4 月 16 日
此功能已随 Databricks CLI 0.248.0 一起发布。
用于 Databricks 资产捆绑的 Python 现在以公共预览版提供。 此功能扩展捆绑包，以便可以将作业定义为 Python 代码，使用元数据动态创建作业，并在捆绑部署期间修改 YAML 或 Python 中定义的作业。 有关详细信息以及开始使用用于 Databricks 资产捆绑包的 Python，请参阅 Python 中的配置。
绑定/取消绑定对 quality_monitor 和 model_serving_endpoint 的支持
2025 年 4 月 9 日
此功能随 Databricks CLI 0.247.0 一起发布。
bind 和 unbind 现在支持 和 命令。 这意味着可以将这些捆绑定义的资源链接到 Azure Databricks 工作区中的现有质量监视器和模型服务终结点，以便它们由 Databricks 资产捆绑包管理。 有关详细信息，请参阅绑定捆绑包资源。
wheel 的动态版本控制
2025 年 3 月 26 日
此功能已随 Databricks CLI 0.245.0 一起发布。
dynamic_version 映射的新设置 artifacts 使捆绑包能够根据 wheel 文件的时间戳来更新 wheel 版本。 无需更新setup.py或pyproject.toml中的版本，可以部署新代码。 该设置仅在 type 设置为 whl 时有效。 请参阅工件。
绑定/取消绑定对其他资源的支持
2025 年 3 月 26 日
此功能已随 Databricks CLI 0.245.0 一起发布。
bind、unbind、registered_model 和卷资源现在支持 和 命令。 这意味着可以将这些捆绑定义的资源链接到 Azure Databricks 工作区中的现有群集、仪表板、已注册模型和卷，以便由 Databricks 资产捆绑包来管理它们。 有关详细信息，请参阅绑定捆绑包资源。
绑定/取消绑定对架构的支持
2025 年 3 月 5 日
此功能已随 Databricks CLI 0.243.0 一起发布。
bind现在支持 unbind 和 命令。 借助这些命令，你可以将捆绑定义的资源链接到 Azure Databricks 工作区中的现有资源，以便由 Databricks 资产捆绑包来管理它们。 有关详细信息，请参阅绑定捆绑包资源。
应用支持
2025 年 1 月 16 日
此功能已随 Databricks CLI 0.239.0 一起发布。
现在，通过在捆绑配置中定义应用资源，可以使用 Databricks 资产捆绑包管理 Databricks 应用部署。 请参阅应用。
卷支持
2024 年 12 月 5 日
此功能已随 Databricks CLI 0.236.0 一起发布。
现在，你可以通过在捆绑包配置中定义卷资源来使用 Databricks 资产捆绑包创建 Unity Catalog 卷。 请参阅卷 (Unity Catalog)。
针对通知目标的变量查找
2024 年 12 月 5 日
此功能已随 Databricks CLI 0.236.0 一起发布。
变量查找现在支持通知目标。 请参阅检索对象的 ID 值。
仪表板支持
2024 年 10 月 30 日
此功能已随 Databricks CLI 0.232.0 一起发布。
现在，可以使用新的仪表板资源类型在捆绑配置中管理 AI/BI 仪表板。 可以使用 bundle generate dashboard 生成仪表板配置，并通过 --force 和 --watch 选项保持仪表板的本地和远程版本处于同步状态。 请参阅仪表板和生成捆绑配置文件。
有关 AI/BI 仪表板的信息，请参阅仪表板。
新捆绑包摘要命令
2024 年 10 月 23 日
此功能已随 Databricks CLI 0.231.0 一起发布。
添加了一个新的 bundle summary 命令。 此命令输出捆绑包的标识和资源摘要，包括资源的深层链接，以便你可以轻松地导航到 Databricks 工作区中的资源。 请参阅输出捆绑包摘要。
有关部署到“共享”但权限冲突的捆绑包的警告
2024 年 10 月 23 日
重要
这是行为变化。
此更改随 Databricks CLI 0.231.0 一起发布。
现在，将捆绑包部署到所有用户均可访问的 /Workspace/Shared 文件夹，但为捆绑包定义的顶级 permissions 与此冲突时，将会显示警报。 请修改为捆绑包定义的权限，或将捆绑包移出 /Workspace/Shared 文件夹。
要修改捆绑包的权限，请参阅权限。
要将捆绑包移出 /Workspace/Shared 文件夹，请更改捆绑包配置中的 workspace.root_path 以指向新位置，然后重新部署捆绑包。 使用 UI 或通过运行 databricks fs rm 来移除旧捆绑包文件夹。
工作区路径现在会自动添加前缀
2024 年 10 月 9 日
重要
这是行为变化。
此更改已随 Databricks CLI 0.230.0 一起发布。
工作区路径现在会自动加上 /Workspace 前缀。 此外，捆绑配置中路径字符串（例如 /Workspace/${workspace.root_path}/...）的所有用法均会自动替换为 ${workspace.root_path}/...，并将在 bundle validate 时生成警告。
如果指定了自定义 workspace.root_path、workspace.artifact_path 或 workspace.file_path，Databricks 资产捆绑包将自动为其添加前缀 /Workspace，但如果将其中任一项用作变量（例如，my_config_path: /Workspace/${workspace.file_path}/config），则需要更新这些条目以移除 /Workspace 前缀，从而避免该警告。
如果你将其中一个作为变量传递并在代码中为它们添加前缀，则需要更新代码以避免这样做。
需要进行此更改的原因是最初当工作区文件系统根目录为 /，且主目录位于 /Users 下时，要通过 Databricks REST API 访问工作区路径，你会直接使用这些路径。 要通过代码访问工作区路径，可以使用 /Workspace 文件路径，还可以使用 /Workspace/Users 下面的主目录。 为了避免工作区路径的这种双重性，以及工作区路径和 Unity Catalog /Volumes 路径之间的歧义，所有工作区路径都带有 /Workspace 前缀。
支持创建通用群集
2024 年 10 月 1 日
此功能已随 Databricks CLI 0.229.0 一起发布。
现在，可以使用新的群集资源类型在捆绑配置中创建通用群集。 请参阅群集。
新 Lakeflow 声明式管道重新创建提示和 –auto-approve 标志
2024 年 9 月 5 日
此功能已随 Databricks CLI 0.228.0 一起发布。
如果存在捆绑配置更改导致管道重新创建，则会立即出现提示。 可以通过指定 --auto-approve 标志来跳过该提示。
添加了对 Unity Catalog 架构资源的支持
2024 年 7 月 31 日
此功能已随 Databricks CLI 0.225.0 一起发布。
现在，可以在捆绑配置中定义 Unity Catalog 架构。 请参阅架构 (Unity Catalog)。
Web 终端中的捆绑包命令
2024 年 7 月 4 日
此功能已随 Databricks CLI 0.223.0 一起发布。
现在，可以使用 Web 终端中的 Databricks CLI 与捆绑包进行交互。 有关使用 Web 终端的信息，请参阅 在 Azure Databricks Web 终端中运行 shell 命令。
添加了对复杂变量的支持
2024 年 6 月 26 日
此功能已随 Databricks CLI v0.222.0 一起发布。
Databricks 资产捆绑包现在支持复杂的变量。 请参阅定义复杂变量。
Databricks 资产捆绑包已正式发布
2024 年 4 月 23 日
通过 Databricks CLI 0.218.0 版本，Databricks 资产捆绑包现已正式发布。