Note
此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。
Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明,包括任何数据使用规定。
groups-v2
CLI 中的命令组允许管理 Databricks 工作区中的组。 组简化了标识管理,从而更轻松地分配对 Databricks 工作区、数据和其他安全对象的访问权限。 最佳做法是在 Unity Catalog 中将工作区访问权限和访问控制策略分配给组,而不是单独分配给用户。
databricks groups-v2 create
在 Databricks 工作区中创建具有唯一名称的新组。
databricks groups-v2 create [flags]
参数
没有
选项
--display-name string
表示人类可读组名称的字符串。
--external-id string
组的外部 ID。
--id string
Databricks 组 ID。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
Examples
以下示例创建一个新组:
databricks groups-v2 create --display-name "Data Engineers"
databricks groups-v2 delete
从 Databricks 工作区中删除组。
databricks groups-v2 delete ID [flags]
参数
ID
Databricks 工作区中组的唯一 ID。
选项
Examples
以下示例删除组:
databricks groups-v2 delete 12345678
databricks groups-v2 get
获取 Databricks 工作区中特定组的信息。
databricks groups-v2 get ID [flags]
参数
ID
Databricks 工作区中组的唯一 ID。
选项
Examples
以下示例获取组详细信息:
databricks groups-v2 get 12345678
databricks groups-v2 列表
获取与 Databricks 工作区关联的组的所有详细信息。
databricks groups-v2 list [flags]
参数
没有
选项
--attributes string
响应中返回的属性列表,用逗号分隔。
--count int
每个页面所需的结果数。
--excluded-attributes string
响应时需要排除的属性的逗号分隔列表。
--filter string
用于筛选结果的查询。
--sort-by string
用于对结果进行排序的属性。
--sort-order ListSortOrder
对结果进行排序的顺序。 支持的值:ascending、descending
--start-index int
指定第一个结果的索引。
Examples
以下示例列出所有组:
databricks groups-v2 list
以下示例列出与筛选器匹配的组:
databricks groups-v2 list --filter "displayName sw \"Data\""
databricks groups-v2 修补程序
部分更新组的详细信息。
databricks groups-v2 patch ID [flags]
参数
ID
Databricks 工作区中的唯一 ID。
选项
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
Examples
以下示例使用 JSON 文件修补组:
databricks groups-v2 patch 12345678 --json @patch.json
databricks groups-v2 更新
通过替换整个组对象来更新组的详细信息。
databricks groups-v2 update ID [flags]
参数
ID
Databricks 组 ID。
选项
--display-name string
表示人类可读组名称的字符串。
--external-id string
组的外部 ID。
--json JSON
内联 JSON 字符串或包含请求正文的 JSON 文件中的 @path。
Examples
以下示例更新组的显示名称:
databricks groups-v2 update 12345678 --display-name "Data Engineers Team"
全局标志
--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 字符串
如果适用,要使用的捆绑包目标