EXTERNAL_TABLES ビュー¶
このInformation Schemaには、指定された(または現在の)データベース内にある各外部テーブルの行が表示されます。
- こちらもご参照ください:
列¶
列名 |
データ型 |
説明 |
---|---|---|
TABLE_CATALOG |
TEXT |
テーブルが属するデータベース |
TABLE_SCHEMA |
TEXT |
テーブルが属するスキーマ |
TABLE_NAME |
TEXT |
テーブルの名前 |
TABLE_OWNER |
TEXT |
テーブルを所有するロールの名前 |
CREATED |
TIMESTAMP_LTZ |
テーブルの作成時刻 |
LAST_ALTERED |
TIMESTAMP_LTZ |
オブジェクトが最後に変更された日時。 使用上の注意 をご参照ください。 |
LAST_DDL |
TIMESTAMP_LTZ |
テーブルまたはビューに対して最後に実行された DDL 操作のタイムスタンプ。 サポートされているすべてのテーブル/ビュー DDL 操作は、このフィールドを更新します。
テーブルパラメーターの設定解除(例: COMMENT、 DATA_RETENTION_TIME など)、テーブル例の変更(ADD / MODIFY / RENAME / DROP)など、 ALTER TABLE の操作はすべてこのフィールドを更新します。 詳細については、 使用上の注意 をご参照ください。 |
LAST_DDL_BY |
TEXT |
最後に DDL 操作を実行したユーザーの現在のユーザー名。ユーザーがドロップされた場合は、 ドロップされたユーザーについては、 USERS ビュー で |
AUTO_CLUSTERING_ON |
BOOLEAN |
テーブルに対して自動クラスタリングが有効になっているかどうか |
COMMENT |
TEXT |
このテーブルに対するコメント |
LOCATION |
TEXT |
読み取られるデータを含むファイルがステージングされる外部ステージ |
FILE_FORMAT_NAME |
TEXT |
外部テーブルのクエリ時にスキャンするステージングされたデータファイルを記述する名前付きファイル形式 |
FILE_FORMAT_TYPE |
TEXT |
外部テーブルのクエリ時にスキャンするステージングデータファイルの形式のタイプ |
使用上の注意¶
ビューには、セッションの現在のロールにアクセス権限が付与されているオブジェクトのみが表示されます。ビューは MANAGE GRANTS 権限を優先しないため、 MANAGE GRANTS 権限を持つユーザーが両方を実行する場合、SHOW コマンドよりも表示される情報が少なくなる場合があります。
ビューには、ドロップされた外部テーブルは含まれません。
クエリで外部テーブルのみを表示するには、 WHERE 句を使用してフィルターします。例:
... WHERE table_schema != 'INFORMATION_SCHEMA'
LAST_ALTERED 列は、オブジェクトに対して以下の操作を実行したときに更新されます。
DDL 操作 。
DML 操作(テーブル用のみ)。
Snowflakeが実行するメタデータのバックグラウンド保守作業。
ビューとテーブルの場合、オブジェクトの最終更新時刻には LAST_DDL 列を使用します。
LAST_DDL 列の値は以下のように更新されます。
テーブルやビューが作成されると、 LAST_DDL のタイムスタンプは CREATED のタイムスタンプと同じになります。
テーブルやビューがドロップされると、 LAST_DDL のタイムスタンプは DELETED のタイムスタンプと同じになります。
最後の DDL データは、列が 追加 される前に発生した操作については利用できません。新しい DDL フィールドは、 DDL 操作が実行されるまで
null
を含みます。複製されたデータベースの場合、 LAST_DDL と LAST_DDL_BY フィールドはプライマリデータベース内のオブジェクトに対してのみ更新されます。フェールオーバー後、 LAST_DDL および LAST_DDL_BY フィールドは、新しく昇格したプライマリデータベースのテーブルおよびビューの DDL 操作用に更新されます。これらのフィールドは、セカンダリデータベース内のオブジェクトについては変更されません。
セカンダリデータベース内のオブジェクトで、リフレッシュ操作中に新しく作成されたオブジェクトの場合、これらのフィールドは
null
になります。
例¶
mydatabase
データベース内のすべてのスキーマ内のすべての外部テーブルのリストを取得します。
SELECT table_name, last_altered FROM mydatabase.information_schema.external_tables;