TAG_REFERENCES_WITH_LINEAGE¶
返回一个表,其中每行显示指定标记与标记关联到的 Snowflake 对象之间的关联。
关联的标记和 Snowflake 对象是与对象直接关联和通过标记世系关联的结果。
语法¶
TAG_REFERENCES_WITH_LINEAGE( '<name>' )
实参¶
'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 |
标签的名称。这是标签的 |
TAG_VALUE |
TEXT |
标签的值。这是标签的 |
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'));