# GS_COPY_SUMMARY_LOG
GS_COPY_SUMMARY_LOG表用于记录COPY执行结果汇总，包括成功导入行数、错误数据行数、忽略行数和空行数等。详细的使用权限，请参见[权限配置](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0939.html#ZH-CN_TOPIC_0000002793699147__section1472611151954)。
表1GS_COPY_SUMMARY_LOG字段 
| 名称        | 类型                       | 描述               |
|:---|:---|:---|
| 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输入的值，表示本次导入的自定义标识信息。               |
   
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- pg_catalog.gs_copy_summary_log表当前没有自动清理机制，需要管理员用户手动执行TRUNCATE语句进行清理。
- pg_catalog.gs_copy_summary_log表当前没有行级访问控制。
- 三权分立机制下，错误日志信息不会记录至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);
  ```
  若用户load_user使用的是M兼容类型数据库，则需通过以下语句在其同名Schema下创建：
  ```
  CREATE TABLE load_user.gs_copy_summary (
      relname       varchar(64),
      begintime     timestamp,
      endtime       timestamp,
      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);
  ```
  
 
