カテゴリ:

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