groups-v2 命令组

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

    对结果进行排序的顺序。 支持的值:ascendingdescending

--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 格式

    日志格式类型,textjson。 默认值为 text

--log-level 字符串

    一个表示日志格式级别的字符串。 如果未指定,则禁用日志格式级别。

-o, --output 类型

    命令输出类型为 textjson。 默认值为 text

-p, --profile 字符串

    要用于运行命令的 ~/.databrickscfg 文件中的配置文件名称。 如果未指定此标志,并且存在命名为 DEFAULT 的配置文件,则使用该配置文件。

--progress-format 格式

    显示进度日志的格式: defaultappendinplacejson

-t, --target 字符串

    如果适用,要使用的捆绑包目标