本文包含有关主要 Databricks 资产捆绑包 功能和变更的详细说明。 捆绑包功能随 Databricks CLI 一起发布。
有关更新的完整列表，请参阅 Databricks CLI GitHub 存储库发行说明。
小窍门
若要收到 Databricks CLI 和捆绑功能的新版本的通知，请为 CLI 存储库配置 GitHub 通知。 请参阅 关于 GitHub 通知。
回退路径的行为更改
重要
Databricks 资产捆绑包当前支持跨配置文件解析相对路径时的回退机制。 此回退将于 2025 年 8 月 27 日删除。
目前，当资源在一个文件中定义，但在另一个目录中被重写时，路径解析基于资源首次定义的路径，这可能导致混淆且容易出错。
例如，在定义的 resources/job.yml 作业（根子文件夹）中为笔记本执行捆绑部署时，笔记本路径设置为 ../src/notebook.py 文件 override.yml （根目录），则首先根据设置路径的配置文件的位置解析为 <BUNDLE_ROOT>/../src/notebook.py笔记本路径。 如果该路径不存在，它将根据定义作业的相对路径解析为 <BUNDLE_ROOT>/src/notebook.py的路径。
在 Databricks CLI 版本 0.252 及更高版本中，如果定义的路径不存在，将发生以下警告：
Warn: path <PATH> is defined relative to the <DIR> directory. Please update the path to be relative to the file where it is defined. The current value will no longer be valid in the next release.
更改后，如果指定的路径不存在，将发生错误。 仅支持直接相对路径。 若要部署捆绑包，必须修复路径。
Lakebase 数据库支持
2025 年 8 月 21 日
此功能已随 Databricks CLI 0.265.0 一起发布。
现在可以在 Databricks 资产捆绑包配置中定义 Lakebase 数据库实例和目录。 请参阅 database_instances 和 database_catalogs。
新脚本包配置
2025 年 7 月 16 日
此功能随 Databricks CLI 0.259.0 一起发布。
现在可以在捆绑包配置中定义脚本，并使用捆绑包配置的身份验证凭据运行这些 bundle run 脚本。 请参阅 “执行脚本 和 脚本”。
默认 python 模板现在使用 uv
2025 年 7 月 2 日
此功能已随 Databricks CLI 0.258.0 一起发布。
默认 Python 捆绑包模板现在要求安装uv并在pyproject.toml目标中使用dev来生成whl项目。 如果捆绑包初始化配置为使用经典计算，则会启用针对目标 artifacts_dynamic_version 的部署预设 dev。 请参阅 自定义预设。
默认 Python 模板默认使用无服务器
2025 年 6 月 25 日
此功能随 Databricks CLI 0.257.0 一起发布。
使用默认 Python 捆绑模板初始化捆绑包时，系统会提示你确认是否要将捆绑包配置为对作业和管道运行使用无服务器计算。 有关捆绑模板的信息，请参阅 Databricks 资产捆绑项目模板。
新的部署预设 artifacts_dynamic_version
2025 年 6 月 18 日
此功能随 Databricks CLI 0.256.0 一起发布。
现已提供新的部署预设 artifacts_dynamic_version 。 这个自定义预设置能够在部署期间动态更新whl工件的版本。 请参阅 自定义预设。
工作区中的组件目前为公共预览版
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 中定义的作业。 要了解更多信息并开始使用 Python 配置 Databricks 资产捆绑包，请参阅 Python 中的捆绑配置。
绑定/取消绑定对 quality_monitor 和 model_serving_endpoint 的支持
2025 年 4 月 9 日
此功能随 Databricks CLI 0.247.0 一起发布。
bind 和 unbind 现在支持 和 命令。 这意味着可以将这些捆绑定义的资源链接到 Azure Databricks 工作区中的现有质量监视器和模型服务终结点，以便它们由 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 资产捆绑包来管理它们。 有关详细信息，请参阅 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 选项保持同步。 请参阅 仪表板 和 databricks 捆绑包生成。
有关 AI/BI 仪表板的信息，请参阅仪表板。
“新建捆绑包摘要”命令
2024 年 10 月 23 日
此功能已随 Databricks CLI 0.231.0 一起发布。
添加了一个新 bundle summary 命令。 此命令输出捆绑包的标识和资源摘要，包括资源的深层链接，以便你可以轻松地导航到 Databricks 工作区中的资源。 请参阅 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 一起发布。
现在可以使用新的群集资源类型在捆绑包配置中创建通用群集。 请参阅群集。
New 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 资产捆绑包现已随 Databricks CLI 0.218.0 版本正式发布。