本文包含有关主要 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 一起发布。
现在可以使用新的群集资源类型在捆绑包配置中创建通用群集。 请参阅群集。
新的 DLT 管道重新创建提示和 -auto-approve 标志
2024 年 9 月 5 日
此功能已随 Databricks CLI 0.228.0 一起发布。
现在，如果存在捆绑配置更改，并将导致重新创建 DLT 管道，系统将会出现提示。 可通过指定 --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 资产捆绑包现已随 Databricks CLI 0.218.0 版本正式发布。