DROP TAG

从系统中移除标签。

有关此命令和标签引用的信息，请参阅 对象的标签配额。

另请参阅：

CREATE TAG、ALTER TAG、SHOW TAGS、UNDROP TAG

语法

DROP TAG [ IF EXISTS ] <name>
Copy

参数

name

标签的标识符。

标识符值必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如 "My object"）。放在双引号内的标识符也区分大小写。

有关更多详细信息，请参阅 标识符要求。

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

OWNERSHIP

标签

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需 同时 被授予该架构的 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

有关标签 DDL 和权限的其他详细信息，请参阅 访问控制权限。

使用说明

  • 在删除标签之前，通过调用 Account Usage 表函数 TAG_REFERENCES_WITH_LINEAGE 确定将标签分配给的所有对象。

  • 如果标签当前被分配给一个 对象，则可以删除该标签。如果无意中删除了标签，请执行 UNDROP TAG 命令。请注意，在 DROP TAG 操作之前，UNDROP TAG 命令会恢复标签分配。

  • 如果给标签 分配 了掩码策略，则无法弃用该标签。

    在此方案中，请先从标签中取消设置掩码策略，然后执行该 DROP TAG 语句。

  • 有关标签 DDL 授权的更多信息，请参阅 所需权限。

  • 如果指定了 IF EXISTS 子句，而目标对象不存在，该命令会成功完成，不会返回错误。

示例

以下示例删除一个标签：

DROP TAG cost_center;
Copy
语言: 中文