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