- スキーマ:
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 |
ステータス: |
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 INTO コマンド10のレコードを取得します。
SELECT file_name, last_load_time FROM snowflake.account_usage.load_history ORDER BY last_load_time DESC LIMIT 10;