スキーマ:

ORGANIZATION_USAGE

TAG_REFERENCES ビュー

重要

この表示は組織アカウントでのみ利用可能です。詳細については、 組織アカウントのプレミアムビュー をご参照ください。

このOrganization Usageビューを使って、オブジェクトとタグの関連付けを識別することができます。

この表示は、オブジェクトとタグの間の直接的な関係のみを記録します。 タグ継承 はこのビューには含まれません。

このビューは、Information Schemaテーブル関数 TAG_REFERENCES を補完します。

組織レベルの列

列名

データ型

説明

ORGANIZATION_NAME

VARCHAR

組織の名前。

ACCOUNT_LOCATOR

VARCHAR

システムが生成したアカウントの識別子。

ACCOUNT_NAME

VARCHAR

ユーザー定義のアカウント識別子。

追加列

列名

データ型

説明

TAG_DATABASE

TEXT

タグが設定されているデータベース。

TAG_SCHEMA

TEXT

タグが設定されているスキーマ。

TAG_ID

NUMBER

タグの内部/システム生成識別子。 システムタグ の場合、この値は NULL であることに注意してください。

TAG_NAME

TEXT

タグの名前。これは、タグの key = 'value' ペアにある key です。

TAG_VALUE

TEXT

タグの値。これは、タグの key = 'value' ペアにある 'value' です。

OBJECT_DATABASE

TEXT

データベースおよびスキーマオブジェクトの参照オブジェクトのデータベース名。オブジェクトがデータベースまたはスキーマオブジェクトでない場合、値は空です。

OBJECT_SCHEMA

TEXT

参照オブジェクトのスキーマ名(スキーマオブジェクトの場合)。参照オブジェクトがスキーマオブジェクト(例: ウェアハウス)でない場合、この値は空です。

OBJECT_ID

NUMBER

参照オブジェクトの内部識別子。

OBJECT_NAME

TEXT

タグの関連付けがオブジェクト上にある場合は、参照オブジェクトの名前。タグの関連付けが列にある場合、Snowflakeは親テーブル名を返します。

OBJECT_DELETED

TIMESTAMP_LTZ

関連するオブジェクトが削除された日時、または親オブジェクトが削除された場合。 . 詳細情報については、 使用上の注意 をご参照ください。

DOMAIN

TEXT

タグの関連付けがオブジェクト上にある場合は、参照オブジェクト(例: テーブル、ビュー)のドメイン。列に対して、タグの関連付けが列にある場合、ドメインは COLUMN です。詳細については、 サポートされているドメイン をご参照ください。

COLUMN_ID

NUMBER

参照列のローカル識別子。タグの関連付けが列でない場合は適用されません。

COLUMN_NAME

TEXT

参照列の名前。タグの関連付けが列でない場合は適用されません。

APPLY_METHOD

TEXT

タグがオブジェクトにどのように割り当てられたかを指定します。設定可能な値は以下の通りです。

  • CLASSIFIED: タグは機密データを含むと分類された列に自動的に適用されました。 タグマッピングについて をご参照ください。

  • INHERITED: このオブジェクトは、Snowflake セキュリティ可能なオブジェクト階層の上位のオブジェクトからタグを継承しました。 タグ継承 をご参照ください。

  • MANUAL: CREATE <オブジェクト> または ALTER <オブジェクト> コマンドを使用して、誰かが手動でオブジェクトにタグを設定しました。 タグのセット をご参照ください。

  • PROPAGATED: タグはオブジェクトからオブジェクトへ自動的に伝播します。 ユーザー定義タグによるタグの自動伝播 をご参照ください。

  • NULL: レガシーの記録。

  • NONE: レガシーの記録。

使用上の注意

  • ビューの遅延は最大24時間です。

  • ビューには、セッションの現在のロールにアクセス権が付与されているオブジェクトのみが表示されます。

  • TAG_DATABASE_ID 列はこのビューに含まれていません。クエリ結果でこの値を取得するには、 TAGS ビュー を使用して JOIN 操作を実行します。

  • この列には、1つ以上のタグが設定されていた、削除された列のタイムスタンプは含まれません。

    参考までに、次のいずれかのイベントが発生すると、列が削除されます。

    • 列がテーブルからドロップされる(つまり、 ALTER TABLE ... DROP COLUMN col_name)、または

    • 列を含む親テーブルがドロップされる(つまり、 DROP TABLE name)、または

    • 列を含む親スキーマがドロップされる(つまり、 DROP SCHEMA name)、または

    • 列を含む親データベースがドロップされます(つまり、 DROP DATABASE name)。

Snowflakeアカウントのタグ参照を返します。

select account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_usage.tag_references
order by tag_name, domain, object_id;
Copy

Snowflakeアカウントでタグが関連付けられているアクティブなオブジェクトを返します。指定された WHERE 句を追加すると、削除されたオブジェクトがフィルターされます。

select account_name, tag_name, tag_value, domain, object_id
from snowflake.organization_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;
Copy