数据存在错误时的导出操作指南

更新时间：2025-05-29 GMT+08:00

查看PDF

对于导出时数据存在错误的原因，通常为将不满足数据库服务端编码的字符串或二进制数据插入到了数据库中，因此推荐在导出时保持客户端编码与数据库服务端编码保持一致，即可跳过服务端编码的合法性校验，也不会进行数据转码。

当客户端编码（client_encoding）与服务端编码（server_encoding）一致时：
- 执行原生数据导出；
- 保证数据完整性和原始性；
- 无需进行字符集转换。
当客户端编码（client_encoding）与服务端编码（server_encoding）不一致时：
- 采用客户端编码作为导出文件目标编码标准；
- 内核中对已有数据先基于服务端编码进行编码合法性校验，存在非法编码的数据会进行报错；
- 内核再将数据进行转码处理，对无法转码（源字符集存在码位，目标字符集不存在码位）的字符进行报错。

当用户的数据库中存在非法编码入库的数据，想要导出时不进行报错，推荐以下两种方案。

首选方案：保持客户端编码与服务端编码保持一致后，将数据以数据库服务端编码进行导出，不进行转码。

设置客户端编码与服务端编码一致。

gaussdb=# SET client_encoding = '{server_encoding}';

执行COPY将数据以标准的CSV格式导出到文件中。
```
gaussdb=# COPY test_copy TO '/data/test_copy.csv' CSV;
```

次选方案：需要依赖数据库内核的转码能力，并对非法编码的字节通过占位符（'?'）进行替换，导出的数据内容会发生变化。

设置数据库客户端编码为目标编码。

gaussdb=# SET client_encoding = {target_encoding};

依赖内核转码能力进行导出，将非法编码的字节进行替换。

gaussdb=# COPY test_copy TO '/data/test_copy.csv' CSV COMPATIBLE_ILLEGAL_CHARS;

须知：

使用COMPATIBLE_ILLEGAL_CHARS参数，当数据中存在非法编码的数据时，会将导出的数据进行修正，数据库内的数据不变，请酌情考虑后使用。
启用COMPATIBLE_ILLEGAL_CHARS参数的修改规则如下：
- 非法字符替换：根据convert_illegal_char_mode参数配置的字符进行替换，默认替换为为'?'（U+003F）字符。
- 零字符替换：对于零字符（U+0000）统一替换成空格字符（U+0020），如果不需要进行零字符替换，需要配置不同兼容性下的零字符功能开关。
关于COMPATIBLE_ILLEGAL_CHAR....参数的具体使用约束，请参考COPY语法章节。

父主题： COPY导入导出最佳实践

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消