TAG_REFERENCES_ALL_COLUMNS¶
返回一个表,其中每行显示分配给特定列的标记名称和标记值。
此函数返回给定表或视图中每列上设置的每个标记,无论标记是直接分配给列还是通过标记世系分配。
语法¶
TAG_REFERENCES_ALL_COLUMNS( '<object_name>' , '<object_domain>' )
实参¶
'object_name'
如果标签关联位于对象上,则为引用对象的名称。
此实参支持表和视图的名称。
'object_domain'
引用的对象的域。
Snowflake 支持此函数的 一个 域:
TABLE
。请注意,
TABLE
域 必须 用于包含列的所有对象,即使对象名称是视图(即视图、物化视图)。
使用说明¶
仅对有权访问指定对象的角色返回结果。
要查看 系统标签 的引用,请使用具有共享 SNOWFLAKE 数据库的 IMPORTED PRIVILEGES 的角色。
当调用 Information Schema 表函数时,会话必须具有正在使用的 INFORMATION_SCHEMA 架构,或者 函数必须使用完全限定的对象名称。有关更多详细信息,请参阅 Snowflake Information Schema。
输出¶
该函数返回以下列:
列 |
数据类型 |
描述 |
---|---|---|
TAG_DATABASE |
TEXT |
在其中设置标签的数据库。 |
TAG_SCHEMA |
TEXT |
在其中设置标签的架构。 |
TAG_NAME |
TEXT |
标签的名称。这是标签的 |
TAG_VALUE |
TEXT |
标签的值。这是标签的 |
LEVEL |
TEXT |
在上面设置标签的对象域。 |
OBJECT_DATABASE |
TEXT |
包含表或视图的数据库名称。 |
OBJECT_SCHEMA |
TEXT |
包含表或视图的架构名称。 |
OBJECT_NAME |
TEXT |
表或视图的名称。 |
DOMAIN |
TEXT |
此值应为 |
COLUMN_NAME |
TEXT |
在上面设置标签的列的名称。 |
示例¶
检索分配到表 my_table
中每一列的标签的列表:
select * from table(my_db.information_schema.tag_references_all_columns('my_table', 'table'));