スキーマ:

ACCOUNT_USAGE

LOAD_HISTORY ビュー

このアカウント使用状況ビューでは、過去365日(1年)以内に COPY INTO <テーブル> コマンドを使用して、テーブルにロードされたデータの履歴を取得できます。ビューには、ロードされたファイルごとに1行が表示されます。

注釈

このビューは、Snowpipeを使用してロードされたデータの履歴を返しません。この履歴情報については、代わりに COPY_HISTORY ビューをクエリします。

列名

データ型

説明

TABLE_ID

NUMBER

ターゲットテーブルの内部/システム生成識別子

TABLE_NAME

TEXT

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

SCHEMA_ID

NUMBER

ターゲットテーブルのスキーマの内部/システム生成識別子

SCHEMA_NAME

TEXT

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

CATALOG_ID

NUMBER

ターゲットテーブルのデータベースの内部/システム生成識別子

CATALOG_NAME

TEXT

ターゲットテーブルのデータベース

FILE_NAME

TEXT

ソースファイルの名前

LAST_LOAD_TIME

TIMESTAMP_LTZ

ロード記録の日時(UTC タイムゾーン)

STATUS

TEXT

ステータス: LOADEDLOAD FAILED、または PARTIALLY LOADED

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

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

使用上の注意

  • 大半の場合、ビューの遅延は最大90分です。以下の条件の両方が真である場合、ビューにおける特定のテーブルのロード履歴の遅延は最大2日になる可能性があります。

    • LOAD_HISTORY で最後に更新されてから、特定のテーブルに追加されたステートメントが32 DML 未満。

    • LOAD_HISTORY で最後に更新されてから、特定のテーブルに追加された行が100行未満。

  • ビューには、エラーの有無にかかわらず完了するまで実行された COPY INTO コマンドのみが含まれます。たとえば、トランザクションがロールバックされた場合、または ON_ERROR = ABORT_STATEMENT コピーオプションが COPY INTO <テーブル> ステートメントに含まれていて、データファイルで検出されたエラーのためにロード操作を中止した場合、レコードは追加されません。

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

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

実行された最新の COPY INTO コマンド10のレコードを取得します。

SELECT file_name, last_load_time FROM snowflake.account_usage.load_history
  ORDER BY last_load_time DESC
  LIMIT 10;
Copy