更新时间:2026-10-21 GMT+08:00
分享

GS_COPY_SUMMARY

GS_COPY_SUMMARY系统视图用于记录COPY执行结果汇总,包括成功行数,出错行数,忽略行数,空行数等。详细的使用权限请参见权限配置。

表1 GS_COPY_SUMMARY字段

名称

类型

描述

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);

相关文档