- スキーマ:
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 |
タグの名前。これは、タグの |
TAG_VALUE |
TEXT |
タグの値。これは、タグの |
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 |
タグがオブジェクトにどのように割り当てられたかを指定します。設定可能な値は以下の通りです。
|
使用上の注意¶
ビューの遅延は最大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;
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;