架构：

ACCOUNT_USAGE

TAG_REFERENCES 视图

此 Account Usage 视图可用于识别对象和标签之间的关联。

此视图仅记录对象与标记之间的直接关系。此视图中不包括标签沿袭。

此视图是对 Information Schema 表函数 TAG_REFERENCES 的补充。

列

列名称

数据类型

描述

TAG_DATABASE

TEXT

在其中设置标签的数据库。

TAG_SCHEMA

TEXT

在其中设置标签的架构。

TAG_ID

NUMBER

内部/系统生成的标签标识符。请注意，对于 系统标签，此值为 NULL。

TAG_NAME

TEXT

标签的名称。这是标签的 key = 'value' 对中的 key。

TAG_VALUE

TEXT

标签的值。这是标签的 key = 'value' 对中的 'value'。

OBJECT_DATABASE

TEXT

数据库和架构对象的引用对象的数据库名称。如果对象不是数据库或架构对象，则该值为空。

OBJECT_SCHEMA

TEXT

引用对象的架构名称（对于架构对象）。如果引用对象不是架构对象（例如仓库），则此值为空。

OBJECT_ID

NUMBER

引用对象的内部标识符。

OBJECT_NAME

TEXT

如果标签关联位于对象上，则为引用对象的名称。如果标签关联位于列上，则 Snowflake 返回父表名称。

OBJECT_DELETED

TIMESTAMP_LTZ

删除关联对象的日期和时间，或者删除父对象的日期和时间。. 有关更多信息，请参阅本主题中的 使用说明 部分。

DOMAIN

TEXT

如果标签关联位于对象上，则引用对象的域（例如表、视图）。对于列，如果标签关联位于列上，则域为 COLUMN 域。有关更多信息，请参阅 支持的域。

COLUMN_ID

NUMBER

引用列的本地标识符；如果标签关联不是列，则不适用。

COLUMN_NAME

TEXT

引用列的名称；如果标签关联不是列，则不适用。

使用说明

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

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

  • 此视图中不包括 TAG_DATABASE_ID 列。若要在查询结果中获取此值，请使用 TAGS 视图 执行 JOIN 操作。

  • 此列不包括已删除列的时间戳，该列在已删除列上设置了一个或多个标签。

    作为参考，当发生以下事件之一时，将生成已删除的列：

    • 从表中删除此列（即 ALTER TABLE ... DROP COLUMN col_name），或

    • 已删除包含此列的父表（即 DROP TABLE name），或

    • 已删除包含此列的父架构（即 DROP SCHEMA name），或

    • 已删除包含此列的父数据库（即 DROP DATABASE name）。

示例

返回 Snowflake 账户的标签参考：

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
order by tag_name, domain, object_id;
Copy

返回 Snowflake 账户中具有标签关联的活动对象。添加指定的 WHERE 子句会筛选已删除的对象：

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;
Copy
语言: 中文