TAG_REFERENCES¶

各行にタグと値の関連付けを表示するテーブルを返します。

関連付けられたタグと値は、オブジェクトへの直接の関連付けまたはタグ系統経由の結果です。

構文¶

TAG_REFERENCES( '<object_name>' , '<object_domain>' )

'object_name'

タグの関連付けがオブジェクト上にある場合は、参照オブジェクトの名前。

'object_domain'

タグの関連付けがオブジェクト上にある場合は、参照オブジェクト（例: テーブル、ビュー）のドメイン。列に対して、タグの関連付けが列にある場合、ドメインは COLUMN です。

次の値のいずれかを使用します。

ACCOUNT | INTEGRATION | ROLE | SHARE | USER | WAREHOUSE | DATABASE | SCHEMA | PROCEDURE | STAGE | STREAM | TABLE | TASK | COLUMN

TABLE のドメイン値は、ビュー、マテリアライズドビュー、外部テーブルなど、テーブルのようなオブジェクトすべてに使用する必要があることに注意してください。

結果は、指定されたオブジェクトにアクセスできるロールに対してのみ返されます。
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'` です。
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('my_table', 'table'));

列 result に関連付けられているタグのリストを取得します。

select *
  from table(my_db.information_schema.tag_references('my_table.result', 'COLUMN'));