架构：: ORGANIZATION_USAGE

TAG_REFERENCES 视图¶

重要

此视图仅在组织账户中可用。有关更多信息，请参阅组织账户中的高级视图。

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

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

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

列¶

列名称	数据类型	描述
ORGANIZATION_NAME	TEXT	组织的名称。
ACCOUNT_LOCATOR	VARCHAR	账户的定位器（系统定义）。
ACCOUNT_NAME	TEXT	账户的名称（用户定义）。
TAG_DATABASE	TEXT	在其中设置标签的数据库。
TAG_SCHEMA	TEXT	在其中设置标签的架构。
TAG_ID	VARCHAR
TAG_NAME	TEXT	标签的名称。这是标签的 `key = 'value'` 对中的 `key`。
TAG_VALUE	TEXT	标签的值。这是标签的 `key = 'value'` 对中的 `'value'`。
OBJECT_DATABASE	TEXT	数据库和架构对象的引用对象的数据库名称。如果对象不是数据库或架构对象，则该值为空。
OBJECT_SCHEMA	VARCHAR	引用对象的架构名称（对于架构对象）。如果引用对象不是架构对象（例如仓库），则此值为空。
OBJECT_ID	NUMBER
OBJECT_NAME	VARCHAR	如果标签关联位于对象上，则为引用对象的名称。
OBJECT_DELETED	TIMESTAMP_LTZ	删除关联对象的日期和时间，或删除父对象的日期和时间。. 有关更多信息，请参阅本主题中的使用说明部分。
DOMAIN	TEXT	引用对象（例如表、视图）的域。
COLUMN_ID	NUMBER
COLUMN_NAME	VARCHAR
APPLY_METHOD	VARCHAR

使用说明¶

视图的延迟时间最长可达 24 小时。

该视图仅显示会话的当前角色已被授予访问权限的对象。
此视图中不包括 TAG_DATABASE_ID 列。若要在查询结果中获取此值，请使用 TAGS 视图执行 JOIN 操作。

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

作为参考，当发生以下事件之一时，将生成已删除的列：
- 从表中删除此列（即 ALTER TABLE ... DROP COLUMN col_name），或
- 已删除包含此列的父表（即 DROP TABLE name），或
- 已删除包含此列的父架构（即 DROP SCHEMA name），或
- 已删除包含此列的父数据库（即 DROP DATABASE name）。

示例¶

返回 Snowflake 账户的标签参考：

select account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_usage.tag_references
order by tag_name, domain, object_id;

Copy

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

select account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;

Copy