CREATE TAG

创建一个新标签。标签是租户级别的元信息对象，可分配给数据库对象以进行治理和分类。

另请参阅：DROP TAG、SHOW TAGS、SET TAG / UNSET TAG。

语法

CREATE TAG [ IF NOT EXISTS ] <tag_name>
    [ ALLOWED_VALUES = ( '<value1>' [, '<value2>', ... ] ) ]
    [ COMMENT = '<string>' ]

参数	描述
`tag_name`	要创建的标签名称。
`ALLOWED_VALUES`	可选的允许值列表。设置后，在 SET TAG 中只能使用这些值。重复值会被自动移除。
`COMMENT`	标签的可选描述。

示例

创建一个带有允许值和注释的标签：

CREATE TAG env ALLOWED_VALUES = ('dev', 'staging', 'prod') COMMENT = 'Environment classification';

创建一个接受任意值的标签：

CREATE TAG owner COMMENT = 'Data owner';

创建一个没有限制的标签：

CREATE TAG cost_center;

验证标签定义：

SELECT name, allowed_values, comment FROM system.tags ORDER BY name;

┌──────────────────────────────────────────────────────────────────────┐
│      name      │       allowed_values       │         comment        │
├────────────────┼────────────────────────────┼────────────────────────┤
│ cost_center    │ NULL                       │                        │
│ env            │ ['dev', 'staging', 'prod'] │ Environment classific… │
│ owner          │ NULL                       │ Data owner             │
└──────────────────────────────────────────────────────────────────────┘

CREATE TAG

语法

示例

文档内容是否有帮助？