类别:

Account Usage 表函数表函数

TAG_REFERENCES_WITH_LINEAGE

返回一个表,其中每行显示指定标记与标记关联到的 Snowflake 对象之间的关联。

关联的标记和 Snowflake 对象是与对象直接关联和通过标记世系关联的结果。

语法

TAG_REFERENCES_WITH_LINEAGE( '<name>' )
Copy

实参

'name'

标签的完全限定名称。

完全限定名称必须按以下格式指定标签的父标签数据库和标签架构:

<tag_database>.<tag_schema>.<tag_name>

使用说明

  • 仅对有权访问指定对象的角色返回结果。

    要查看 系统标签 的引用,请使用具有共享 SNOWFLAKE 数据库的 IMPORTED PRIVILEGES 的角色。

  • 调用 Account Usage 表函数时,会话必须正在使用 Account Usage 架构。有关更多详细信息,请参阅 Account Usage

  • 与 Account Usage 视图类似,请考虑调用此表函数时的延迟。该表函数的预期延迟与 TAG_REFERENCES 视图的延迟相似。

输出

该函数返回以下列:

数据类型

描述

TAG_DATABASE

TEXT

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

TAG_SCHEMA

TEXT

在其中设置标签的架构。

TAG_ID

NUMBER

内部/系统生成的标签标识符。

TAG_NAME

TEXT

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

TAG_VALUE

TEXT

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

LEVEL

TEXT

在上面设置标签的对象域。

OBJECT_DATABASE

TEXT

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

OBJECT_SCHEMA

TEXT

引用对象的架构名称(对于架构对象)。如果引用对象不是架构对象(例如仓库),则此值为空。

OBJECT_ID

NUMBER

内部/系统生成的对象标识符。

OBJECT_NAME

TEXT

如果标签关联位于对象上,则为引用对象的名称。

OBJECT_DELETED

TIMESTAMP_LTZ

删除关联对象或列的日期和时间,或者删除父对象的日期和时间。

DOMAIN

TEXT

如果标签关联位于对象上,则引用对象的域(例如表、视图)。如果标签关联位于列上,则域为 COLUMN。

COLUMN_ID

NUMBER

内部/系统生成的列标识符。

COLUMN_NAME

TEXT

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

示例

检索 cost_center 标签的标签关联列表:

select *
  from table(snowflake.account_usage.tag_references_with_lineage('my_db.my_schema.cost_center'));
Copy
语言: 中文