类别:

Information Schema表函数

TAG_REFERENCES_ALL_COLUMNS

返回一个表,其中每行显示分配给特定列的标记名称和标记值。

此函数返回给定表或视图中每列上设置的每个标记,无论标记是直接分配给列还是通过 标签继承 分配。

语法

TAG_REFERENCES_ALL_COLUMNS( '<object_name>' , '<object_domain>' )
Copy

实参

'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

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

TAG_VALUE

TEXT

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

APPLY_METHOD

TEXT

指定如何将标签分配给对象。可能的值包括以下内容:

  • CLASSIFIED:该标签自动应用于被归类为包含敏感数据的列。请参阅 关于标签映射

  • INHERITED:该对象继承了 Snowflake 安全对象层次结构中较高层级的对象的标签。请参阅 标签继承

  • MANUAL:有的人会使用 CREATE <object> 或 ALTER <object> 命令在对象上手动设置标签。请参阅 设置标签

  • PROPAGATED:该标签自动从一个对象传播到另一个对象。请参阅 使用用户定义的标签自动传播标签

  • NULL:旧版记录。

  • NONE:旧版记录。

LEVEL

TEXT

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

OBJECT_DATABASE

TEXT

包含表或视图的数据库名称。

OBJECT_SCHEMA

TEXT

包含表或视图的架构名称。

OBJECT_NAME

TEXT

表或视图的名称。

DOMAIN

TEXT

此值应为 COLUMN,因为此函数返回在表或视图中的所有列上设置的所有标签。

COLUMN_NAME

TEXT

在上面设置标签的列的名称。

示例

检索分配到表 my_table 中每一列的标签的列表:

select *
  from table(my_db.information_schema.tag_references_all_columns('my_table', 'table'));
Copy
语言: 中文