注释
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。
account groups
Databricks CLI 中的命令组包含用于对组执行创建、获取、列出、更新和删除作的命令。 组简化了标识管理，使对 Databricks 帐户、数据和其他安全对象的访问权限更易于分配。 请参阅组。
databricks 帐户组创建
在 Databricks 帐户中创建具有唯一名称的新组。
databricks account groups create [flags]
选项
--display-name string
表示人类可读组名称的字符串。
--external-id string
组的外部 ID。
--id string
Databricks 组 ID。
--json JSON
包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件
例子
以下示例使用命令行标志创建组：
databricks account groups create --display-name "Data Scientists"
以下示例使用 JSON 创建组：
databricks account groups create --json '{"displayName": "Data Scientists", "externalId": "ds-group-001"}'
以下示例使用 JSON 文件创建组：
databricks account groups create --json @group.json
databricks 帐户组删除
从 Databricks 帐户中删除组。
databricks account groups delete ID [flags]
Arguments
ID
Databricks 帐户中组的唯一 ID。
选项
例子
以下示例按 ID 删除组：
databricks account groups delete 12345
databricks 帐户组获取
获取 Databricks 帐户中特定组的信息。
databricks account groups get ID [flags]
Arguments
ID
Databricks 帐户中组的唯一 ID。
选项
例子
以下示例按 ID 获取组：
databricks account groups get 12345
databricks 帐户组列表
获取与 Databricks 帐户关联的组的所有详细信息。
重要
从 2025 年 8 月 22 日起，此命令不会返回成员。 而是应通过循环访问“获取组详细信息”来检索成员。
databricks account groups list [flags]
选项
--attributes string
响应中返回的属性列表，用逗号分隔。
--count int
每个页面所需的结果数。
--excluded-attributes string
响应时需要排除的属性的逗号分隔列表。
--filter string
用于筛选结果的查询。
--sort-by string
用于对结果进行排序的属性。
--sort-order ListSortOrder
对结果进行排序的顺序。 支持的值：ascending、descending。
--start-index int
指定第一个结果的索引。
例子
以下示例列出所有组：
databricks account groups list
以下示例列出带分页的组：
databricks account groups list --count 10 --start-index 0
以下示例列出具有筛选器的组：
databricks account groups list --filter "displayName eq \"Data Scientists\""
databricks 帐户组修补程序
部分更新组的详细信息。
databricks account groups patch ID [flags]
Arguments
ID
Databricks 工作区中的唯一 ID。
选项
--json JSON
包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件
例子
以下示例使用 JSON 修补组：
databricks account groups patch 12345 --json '{"displayName": "Updated Group Name"}'
以下示例使用 JSON 文件修补组：
databricks account groups patch 12345 --json @patch-group.json
databricks 帐户组更新
通过替换整个组对象来更新组的详细信息。
databricks account groups update ID [flags]
Arguments
ID
Databricks 组 ID。
选项
--display-name string
表示人类可读组名称的字符串。
--external-id string
组的外部 ID。
--id string
Databricks 组 ID。
--json JSON
包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件
例子
以下示例使用命令行标志更新组：
databricks account groups update 12345 --display-name "Updated Data Scientists"
以下示例使用 JSON 更新群组：
databricks account groups update 12345 --json '{"displayName": "Updated Data Scientists", "externalId": "ds-group-002"}'
以下示例使用 JSON 文件更新组：
databricks account groups update 12345 --json @update-group.json
全局标志
--debug
是否启用调试日志记录。
-h 或 --help
显示 Databricks CLI、相关命令组或相关命令的帮助。
--log-file 字符串
一个字符串，表示要将输出日志写入到的文件。 如果未指定此标志，则默认会将输出日志写入到 stderr。
--log-format 格式
日志格式类型，text 或 json。 默认值为 text。
--log-level 字符串
一个表示日志格式级别的字符串。 如果未指定，则禁用日志格式级别。
-o, --output 类型
命令输出类型为 text 或 json。 默认值为 text。
-p, --profile 字符串
要用于运行命令的 ~/.databrickscfg 文件中的配置文件名称。 如果未指定此标志，并且存在命名为 DEFAULT 的配置文件，则使用该配置文件。
--progress-format 格式
显示进度日志的格式： default、 append、 inplace或 json
-t, --target 字符串
如果适用，要使用的捆绑包目标