カテゴリ:: Information Schema、テーブル関数

TAG_REFERENCES_ALL_COLUMNS¶

各行に特定の列に割り当てられたタグ名とタグ値が表示されているテーブルを返します。

この関数は、タグが列に直接割り当てられているか、タグ継承を介して割り当てられているかに関係なく、特定のテーブルまたはビューのすべての列に設定されているすべてのタグを返します。

構文¶

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

Copy

引数¶

'object_name'

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

この引数は、テーブル名とビュー名をサポートします。

'object_domain'

参照されるオブジェクトのドメイン。

Snowflakeは、この関数のドメイン 1つをサポートしています。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 <オブジェクト> または ALTER <オブジェクト> コマンドを使用して、誰かが手動でオブジェクトにタグを設定しました。タグのセットをご参照ください。 `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