注释
此信息适用于 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
为其分配标记的实体的类型。 允许的值为: dashboards, geniespaces。
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
为其分配标记的实体的类型。 允许的值为: dashboards, geniespaces。
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
为其分配标记的实体的类型。 允许的值为: dashboards, geniespaces。
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
为其分配标记的实体的类型。 允许的值为: dashboards, geniespaces。
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
为其分配标记的实体的类型。 允许的值为: dashboards, geniespaces。
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 格式
日志格式类型,text 或 json。 默认值为 text。
--log-level 字符串
一个表示日志格式级别的字符串。 如果未指定,则禁用日志格式级别。
-o, --output 类型
命令输出类型为 text 或 json。 默认值为 text。
-p, --profile 字符串
要用于运行命令的 ~/.databrickscfg 文件中的配置文件名称。 如果未指定此标志,并且存在命名为 DEFAULT 的配置文件,则使用该配置文件。
--progress-format 格式
显示进度日志的格式: default、 append、 inplace或 json
-t, --target 字符串
如果适用,要使用的捆绑包目标