ALTER 管控标记

适用于:检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 18.1 及更高 版本检查标记为“是 Unity 目录”

更改受治理标记的说明或允许的值集。

若要执行此语句,必须具有 MANAGE 对受管理标记的权限。

Syntax

ALTER GOVERNED TAG tag_key { SET DESCRIPTION description | SET VALUES ( value_name [, ...] ) }

Parameters

  • tag_key

    帐户中现有受治理标记的标记键。 如果没有带此标记键的受控制标记,Azure Databricks将返回 NOT_FOUND 错误。

  • SET DESCRIPTION 说明

    更新受治理标记的说明。 description 是 STRING 文本。

  • SET VALUES (value_name [, ...] )

    更新受治理标记的允许值。 此操作是声明性的,这意味着提供的列表将完全替换现有的允许值。 删除新列表中未包含的任何以前定义的值。

    • value_name

      字符串文本。 允许的值的名称。 区分大小写。

示例

-- Remove all allowed values, making the tag key-only.
> ALTER GOVERNED TAG isPii SET VALUES ();

-- Replace the allowed values list.
> ALTER GOVERNED TAG sensitivity_level SET VALUES ('low', 'medium', 'high');

-- Update the description.
> ALTER GOVERNED TAG pii SET DESCRIPTION 'Indicates what kind of personal identifiable information the asset contains';