EXTERNAL_TABLES ビュー¶

このInformation Schemaには、指定された（または現在の）データベース内にある各外部テーブルの行が表示されます。

こちらもご参照ください。: COLUMNS ビュー、 VIEWS ビュー

列¶

列名	データ型	説明
TABLE_CATALOG	TEXT	テーブルが属するデータベース
TABLE_SCHEMA	TEXT	テーブルが属するスキーマ
TABLE_NAME	TEXT	テーブルの名前
TABLE_OWNER	TEXT	テーブルを所有するロールの名前
CREATED	TIMESTAMP_LTZ	テーブルの作成時刻
LAST_ALTERED	TIMESTAMP_LTZ	オブジェクトが DML、 DDL、またはバックグラウンドでのメタデータ処理によって最後に変更された日時。使用上の注意をご参照ください。
LAST_DDL	TIMESTAMP_LTZ	テーブルまたはビューに対して最後に実行された DDL 操作のタイムスタンプ。サポートされているすべてのテーブル/ビュー DDL 操作は、このフィールドを更新します。 { CREATE \| ALTER \| DROP \| UNDROP } TABLE { CREATE \| ALTER \| DROP } VIEW テーブルパラメーターの設定解除（例: COMMENT、 DATA_RETENTION_TIME など）、テーブル例の変更（ADD / MODIFY / RENAME / DROP）など、 ALTER TABLE の操作はすべてこのフィールドを更新します。詳細については、使用上の注意をご参照ください。
LAST_DDL_BY	TEXT	最後に DDL 操作を実行したユーザーの現在のユーザー名。ユーザーがドロップされた場合は、 `DROPPED_USER(<ID>)` を表示します。ドロップされたユーザーについては、 USERS ビューで `<ID>` と USER_ID 列を結合することができます。
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 操作（テーブル用のみ）。この列は、 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 になります。
LAST_ALTERED 列は、外部テーブルの最終更新時刻を必ずしも示すものではありません。自動更新された外部テーブルの最終更新時刻を取得するには、 SYSTEM$EXTERNAL_TABLE_PIPE_STATUS 関数を使用します。この関数は、Snowflake が最後に登録したファイルのタイムスタンプなどの情報を返します。

例¶

mydatabase データベース内のすべてのスキーマ内のすべての外部テーブルのリストを取得します。

SELECT table_name, last_altered FROM mydatabase.information_schema.external_tables;

Copy