GS_COPY_SUMMARY
GS_COPY_SUMMARY系统视图用于记录COPY执行结果汇总,包括成功行数,出错行数,忽略行数,空行数等。详细的使用权限请参见权限配置。
| 名称 | 类型 | 描述 |
|---|---|---|
| relname | text | 本次导入的目标表名。 |
| begintime | timestamp with time zone | 导入任务开始时间。 |
| endtime | timestamp with time zone | 导入任务结束时间。 |
| id | bigint | 本次导入的事务id。 |
| pid | bigint | 本次导入工作线程id。 |
| readrows | bigint | 本次导入任务共计读取的数据行数。 |
| skiprows | bigint | 本次导入任务共计跳过的数据行数。 |
| loadrows | bigint | 本次导入任务成功导入的数据行数。 |
| errorrows | bigint | 本次导入任务的错误数据行数。 |
| whenrows | bigint | 本次导入任务违反when过滤条件的数据行数。 |
| allnullrows | bigint | 全部字段都为空的数据行数。 |
| detail | text | 本次导入任务的导入情况总结。主要包括成功导入行数、错误数据行数、违反when条件行数和字段全空行数。 |
| custom_id | text | 关联的COPY语法中copy_custom_id输入的值,表示本次导入的自定义标识信息。 |
- 查询pg_catalog.gs_copy_summary系统视图时,显示当前DN节点上pg_catalog.gs_copy_summary_log表中的数据。等同于执行以下语句:
SELECT * FROM pg_catalog.gs_copy_summary_func(false);
- 视图默认不对pg_catalog.gs_copy_summary_old表做UNION ALL操作,如果想要兼容查询pg_catalog.gs_copy_summary_old表中的数据,可以执行以下语句进行查询:
SELECT * FROM pg_catalog.gs_copy_summary_func(true);
- 从此版本开始,gs_copy_summary由系统表改成系统视图,因此无法对其执行TRUNCATE操作进行清理,执行TRUNCATE操作会抛出无法对视图进行此操作的相关报错。清理copy相关日志信息数据的两种情况如下。
- 非三权分立下,需要系统管理员用户执行以下语句进行清理:
TRUNCATE TABLE pg_catalog.gs_copy_summary_log;
- 三权分立下,使用普通用户清理同名schema下的gs_copy_summary表即可。
- 非三权分立下,需要系统管理员用户执行以下语句进行清理:
- 三权分立机制下,错误日志信息不会记录至pg_catalog.pgxc_copy_error_log和pg_catalog.gs_copy_error_log。若用户load_user需记录错误信息,需通过以下语句在其同名Schema下创建:
CREATE TABLE load_user.gs_copy_summary(relname varchar, begintime timestamptz, endtime timestamptz, id bigint, pid bigint, readrows bigint, skiprows bigint, loadrows bigint, errorrows bigint, whenrows bigint, allnullrows bigint, detail text); CREATE INDEX gs_copy_summary_idx ON load_user.gs_copy_summary(id);
(可选)在表上添加custom_id列:
ALTER TABLE load_user.gs_copy_summary ADD COLUMN custom_id varchar(64);