架构:

ACCOUNT_USAGE

TAGS 视图

此 Account Usage 视图列出了账户中的标签。

列名称

数据类型

描述

TAG_ID

NUMBER

标签的本地标识符。

TAG_NAME

TEXT

标签的名称。

TAG_SCHEMA_ID

NUMBER

标签架构的本地标识符。

TAG_SCHEMA

TEXT

标签所在架构的名称。

TAG_DATABASE_ID

NUMBER

标签所在数据库的本地标识符。

TAG_DATABASE

TEXT

标签所在数据库的名称。

TAG_OWNER

TEXT

拥有标签的角色的名称。

TAG_COMMENT

TEXT

标签的注释(如果有)。

CREATED

TIMESTAMP_LTZ

创建标签的日期和时间。

LAST_ALTERED

TIMESTAMP_LTZ

对象上次经 DML、DDL 或后台元数据操作修改的日期和时间。请参阅 使用说明

DELETED

TIMESTAMP_LTZ

弃用标签的日期和时间,或弃用其父级的日期和时间。

ALLOWED_VALUES

ARRAY

指定对 对象 设置标签时可以分配给标签的可能字符串值;如果标签没有任何指定的允许值,则为 NULL。有关详细信息,请参阅 设置允许的标签值列表

OWNER_ROLE_TYPE

TEXT

拥有对象的角色类型,例如 ROLE. 如果 Snowflake Native App 拥有该对象,则该值为 APPLICATION. 如果您删除该对象,则 Snowflake 会返回 NULL,原因是删除的对象不具有所有者角色。

PROPAGATE

VARCHAR

表示标签是否配置为自动传播。可能的值如下:

  • NULL – 标签不会传播。

  • ON_DEPENDENCY – 当存在对象依赖关系时(例如,从标记表创建视图),标签会传播。

  • ON_DATA_MOVEMENT – 当有数据移动时(例如,使用 CTAS 语句从标记表创建表),标签会传播。

  • ON_DEPENDENCY_AND_DATA_MOVEMENT – 存在对象依赖关系和数据移动时,标签都会传播。

ON_CONFLICT

VARCHAR

如果标签配置为自动传播,则指明当要传播的标签的值与手动将标签应用于同一对象时指定的值冲突时会发生什么。有关更多信息,请参阅 标签传播冲突

使用说明

  • 视图的延迟时间最长可达 120 分钟(2 小时)。

  • 该视图仅显示会话的当前角色已被授予访问权限的对象。

  • 对对象执行以下操作时,将更新 LAST_ALTERED 列:

    • DDL 操作。

    • DML 操作(仅适用于表)。即使 DML 语句不影响任何行,也会更新此列。

    • 由 Snowflake 对元数据执行的后台维护操作。

示例

返回 Snowflake 账户的标签参考:

select * from snowflake.account_usage.tags
order by tag_name;
Copy
语言: 中文