CREATE TAG

创建新标签或替换系统中的现有标签。

另请参阅：

指定标签值、TAGS 视图、标签 DDL 参考

语法

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name> [ COMMENT = '<string_literal>' ]

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name>
    [ ALLOWED_VALUES '<val_1>' [ , '<val_2>' [ , ... ] ] ]
Copy

必填参数

name

标签的标识符。使用 CREATE <object> 语句或 ALTER <object> 语句为 对象 分配标签字符串值。

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

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

可选参数

ALLOWED_VALUES 'val_1' [ , 'val_2' [ , ... ] ]

指定使用对应的 CREATE <object> 或 ALTER <object> 命令在 对象 上设置标签时，可以分配给标签的可能字符串值的逗号分隔列表。

此列表中的最大标签值数为 300。

默认值：NULL（允许所有字符串值，包括空字符串值，即 ' '）。

COMMENT = 'string_literal'

指定标签的注释。

默认：无值

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

CREATE TAG

架构

请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。

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

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

有关标签 DDL 和权限的其他详细信息，请参阅 管理标签。

使用说明

  • Snowflake 将账户中的标签数限制为 10,000。

  • 有关如何将标签关联到 Snowflake 对象的更多信息，请参阅 Object Tagging。

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

  • 关于元数据：

    注意

    客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

  • CREATE OR REPLACE <object> 语句是原子的。也就是说，当对象被替换时，旧对象将被删除，新对象将在单个事务中创建。

示例

使用键 cost_center 创建标签。

CREATE TAG cost_center COMMENT = 'cost_center tag';
Copy
语言: 中文