# GS_COPY_SUMMARY
GS_COPY_SUMMARY系统视图用于记录COPY执行结果汇总，包括成功行数，出错行数，忽略行数，空行数等。详细的使用权限请参见[权限配置](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0939.html#ZH-CN_TOPIC_0000002793699147__section1472611151954)。
表1GS_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输入的值，表示本次导入的自定义标识信息。               |
   
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
- 查询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);
  ```
  
 
