LOAD_HISTORY 视图¶

通过此 Account Usage 视图，可以使用 COPY INTO <table> 命令检索过去 365 天（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	状态：`LOADED`、`LOAD 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 中更新以来，添加到给定表中的 DML 语句少于 32 条。
- 自上次在 LOAD_HISTORY 中更新以来，添加到给定表中的行数少于 100 行。

该视图仅包括已执行并完成的 COPY INTO 命令，无论是否出错。例如，如果事务已回滚，或者 COPY INTO <table> 语句中包含 ON_ERROR = ABORT_STATEMENT 复制选项，并且数据文件中检测到的错误中止加载操作，则不会添加任何记录。
当包含引用 LAST_LOAD_TIME 列的 WHERE 子句时，可以指定一周中的任何一天。例如，2016 年 4 月 1 日是星期五；但是，改为指定星期日不会影响查询结果：
```
WHERE last_load_time > 'Sun, 01 Apr 2016 16:00:00 -0800'
```
Copy

复制加载历史记录后，LOAD_HISTORY Account Usage 视图仅显示目标表上最近一次截断操作后的历史记录。这与没有复制的视图不同，后者可显示完整的数据加载历史记录。

检索最近执行的 10 个 COPY INTO 命令的记录：

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

Copy