LOAD_HISTORY ビュー

この情報スキーマビューでは、 COPY INTO <テーブル> コマンドを使用してテーブルにロードされたデータの履歴を取得できます。ビューには、ロードされたファイルごとに1行が表示されます。

注釈

ビューには、エラーの有無にかかわらず完了まで実行された COPY INTO コマンドのみが含まれます。

列名

データ型

説明

SCHEMA_NAME

TEXT

ターゲットテーブルのスキーマ

FILE_NAME

TEXT

ソースファイルの名前

TABLE_NAME

TEXT

ターゲットテーブルの名前

LAST_LOAD_TIME

TIMESTAMP_LTZ

ロードレコードのタイムスタンプ

STATUS

TEXT

ステータス:ロード済み、ロード失敗、または部分的にロード済み

ROW_COUNT

NUMBER

ソースファイルからロードされた行数

ROW_PARSED

NUMBER

ソースファイルから解析された行数

FIRST_ERROR_MESSAGE

TEXT

ソースファイルの最初のエラー

FIRST_ERROR_LINE_NUMBER

NUMBER

最初のエラーの行番号

FIRST_ERROR_CHARACTER_POSITION

NUMBER

最初のエラー文字の位置

FIRST_ERROR_COL_NAME

TEXT

最初のエラーの列名

ERROR_COUNT

NUMBER

ソースファイル内のエラー行の数

ERROR_LIMIT

NUMBER

エラーの数がこの制限に達した場合、中止します

使用上の注意

  • Snowflakeは、過去14日以内に実行された COPY INTO コマンドの履歴データを保持します。

  • COPY INTO コマンドの履歴データは、テーブルがドロップされるとシステムから削除されます。

  • このビューは、10、000行の上限を返します。この制限を回避するには、 COPY_HISTORY 関数 (情報スキーマ)または ビュー (アカウントの使用)を使用します。

  • LAST_LOAD_TIME 列を参照する WHERE 句を含める場合、曜日を指定できます。例えば、4月の1、2016は金曜日でした。ただし、代わりに日曜日を指定しても、クエリ結果には影響しません。

    WHERE last_load_time > 'Sun, 01 Apr 2016 16:00:00 -0800'
    

4月1、2016以降、 MYDB.PUBLIC.MYTABLE テーブルにロードされたデータの履歴を取得します。4月の1が過去14日以内に発生したと仮定します。

USE DATABASE mydb;

SELECT * FROM information_schema.load_history
  WHERE schema_name=current_schema() AND
  table_name='MYTABLE' AND
  last_load_time > 'Fri, 01 Apr 2016 16:00:00 -0800';

MYDB データベースに対して実行された10個の最新のCOPY INTOコマンドのレコードを取得します。

USE DATABASE mydb;

SELECT * FROM information_schema.load_history
  ORDER BY last_load_time DESC
  LIMIT 10;