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

オブジェクトが最後に変更された日時。 使用上の注意 をご参照ください。

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 操作(テーブル用のみ)。

    • 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;
Copy