workspace-entity-tag-assignments 命令组

注释

此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。

Databricks CLI 的使用须遵守 Databricks 许可Databricks 隐私声明,包括任何数据使用规定。

workspace-entity-tag-assignments Databricks CLI 中的命令组包含用于管理工作区范围内对象的标记分配的命令。

databricks workspace-entity-tag-assignments create-tag-assignment

为工作区范围内的对象创建标记分配。

databricks workspace-entity-tag-assignments create-tag-assignment ENTITY_TYPE ENTITY_ID TAG_KEY [flags]

Arguments

ENTITY_TYPE

    为其分配标记的实体的类型。 允许的值为: dashboardsgeniespaces

ENTITY_ID

    为其分配标记的实体的标识符。

TAG_KEY

    标记的键。 不允许字符,.:/-=和前导/尾随空格。

选项

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件

--tag-value string

    标记的值。

全局标志

示例

以下示例为仪表板创建标记分配:

databricks workspace-entity-tag-assignments create-tag-assignment dashboards abc123def456 environment --tag-value production

以下示例为 Genie 空间创建标记分配:

databricks workspace-entity-tag-assignments create-tag-assignment geniespaces xyz789 department --tag-value engineering

以下示例使用 JSON 创建标记分配:

databricks workspace-entity-tag-assignments create-tag-assignment dashboards abc123def456 project --json '{"tag_value": "analytics"}'

databricks workspace-entity-tag-assignments delete-tag-assignment

从工作区范围内的对象中删除标记分配。

databricks workspace-entity-tag-assignments delete-tag-assignment ENTITY_TYPE ENTITY_ID TAG_KEY [flags]

Arguments

ENTITY_TYPE

    为其分配标记的实体的类型。 允许的值为: dashboardsgeniespaces

ENTITY_ID

    为其分配标记的实体的标识符。

TAG_KEY

    标记的键。 不允许字符,.:/-=和前导/尾随空格。

选项

全局标志

示例

以下示例从仪表板中删除标记分配:

databricks workspace-entity-tag-assignments delete-tag-assignment dashboards abc123def456 environment

以下示例从 Genie 空间中删除标记分配:

databricks workspace-entity-tag-assignments delete-tag-assignment geniespaces xyz789 department

databricks workspace-entity-tag-assignments get-tag-assignment

检索工作区范围的对象的标记分配。

databricks workspace-entity-tag-assignments get-tag-assignment ENTITY_TYPE ENTITY_ID TAG_KEY [flags]

Arguments

ENTITY_TYPE

    为其分配标记的实体的类型。 允许的值为: dashboardsgeniespaces

ENTITY_ID

    为其分配标记的实体的标识符。

TAG_KEY

    标记的键。 不允许字符,.:/-=和前导/尾随空格。

选项

全局标志

示例

以下示例获取仪表板的标记分配:

databricks workspace-entity-tag-assignments get-tag-assignment dashboards abc123def456 environment

以下示例获取 Genie 空间的标记分配:

databricks workspace-entity-tag-assignments get-tag-assignment geniespaces xyz789 department

databricks workspace-entity-tag-assignments list-tag-assignments

列出工作区范围对象的所有标记分配。

databricks workspace-entity-tag-assignments list-tag-assignments ENTITY_TYPE ENTITY_ID [flags]

Arguments

ENTITY_TYPE

    为其分配标记的实体的类型。 允许的值为: dashboardsgeniespaces

ENTITY_ID

    为其分配标记的实体的标识符。

选项

--page-size int

    每个页面要返回的最大标记分配数。

--page-token string

    用于检索下一页结果的令牌。

全局标志

示例

以下示例列出仪表板的所有标记分配:

databricks workspace-entity-tag-assignments list-tag-assignments dashboards abc123def456

以下示例列出具有分页的标记分配:

databricks workspace-entity-tag-assignments list-tag-assignments dashboards abc123def456 --page-size 10

databricks workspace-entity-tag-assignments update-tag-assignment

更新工作区范围的对象的标记分配。

databricks workspace-entity-tag-assignments update-tag-assignment ENTITY_TYPE ENTITY_ID TAG_KEY UPDATE_MASK [flags]

Arguments

ENTITY_TYPE

    为其分配标记的实体的类型。 允许的值为: dashboardsgeniespaces

ENTITY_ID

    为其分配标记的实体的标识符。

TAG_KEY

    标记的键。 不允许字符,.:/-=和前导/尾随空格。

UPDATE_MASK

    字段掩码必须是单个字符串,多个字段用逗号分隔(无空格)。 字段路径是相对于资源对象而言的,通过点(.)来导航子字段(例如,author.given_name)。 不允许对序列或映射字段中的元素进行规范,因为只能指定整个集合字段。 字段名称必须与资源字段名称完全匹配。

    星号 (*) 字段掩码指示完全替换。 建议始终显式列出要更新的字段,避免使用通配符,因为如果 API 将来发生更改,可能会导致意外结果。

选项

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件

--tag-value string

    标记的值。

全局标志

示例

以下示例更新仪表板的标记分配:

databricks workspace-entity-tag-assignments update-tag-assignment dashboards abc123def456 environment "tag_value" --tag-value staging

以下示例使用 JSON 更新标记分配:

databricks workspace-entity-tag-assignments update-tag-assignment geniespaces xyz789 department "tag_value" --json '{"tag_value": "sales"}'

全局标志

--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 字符串

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