PostgreSQL 批量插入数据时，推荐使用 COPY 命令替代多条 INSERT 语句，适用于服务端可访问文件或客户端支持 STDIN 的场景，需注意表锁权和文件权限风险。
先说结论：COPY 命令通过减少网络往返和事务开销实现批量加载，适合万级以上数据导入，操作前需确认文件权限和表锁状态。
- 先定位：确认数据源格式为 CSV 或文本，且数据库用户拥有表写入权限。
- 先做：优先使用客户端 COPY FROM STDIN 或服务端 COPY FROM 'filepath' 执行导入。
- 再验证：导入完成后检查受影响行数与目标表总数是否一致。
命令速用版
客户端导入标准命令：
COPY table_name (column1, column2) FROM STDIN WITH (FORMAT csv, HEADER true);服务端文件导入命令：
COPY table_name FROM '/path/to/file.csv' WITH (FORMAT csv, HEADER true);为什么会这样
COPY 命令性能优于 INSERT 的核心原因是减少了网络交互次数和事务提交开销。
普通 INSERT 每条语句都需要一次网络往返和独立的事务处理逻辑，而 COPY 将整个数据块视为单一操作，数据库内部直接解析数据流写入存储引擎，避免了逐条解析 SQL 语句的 CPU 消耗。
分步处理
1. 准备数据文件：确保 CSV 文件编码为 UTF-8，列顺序与目标表一致。
2. 检查权限：服务端 COPY 需要超级用户或 pg_read_server_files 角色权限，客户端 COPY 无需特殊文件权限。
3. 执行导入：在 psql 或驱动中执行 COPY 命令，若使用 STDIN 需配合客户端流式传输。
4. 处理异常：若导入中途失败，COPY 事务会自动回滚，需检查错误日志定位坏数据行。
怎么验证是否生效
执行查询检查行数：
SELECT count(*) FROM table_name;对比导入前的行数与 COPY 命令返回的 COPY n 提示中的 n 值是否一致。
查看数据库日志文件，确认无 ERROR 或 FATAL 级别报错。
常见坑
1. 文件路径权限：服务端 COPY 只能访问数据库服务器文件系统，且受 restricted_access 配置限制。
2. 外键约束：批量导入前若存在外键检查，可能因数据顺序问题导致失败，建议先禁用约束再启用。
3. 事务锁：COPY 操作会持有表锁，大表导入期间可能阻塞其他读写业务。
常见问题
COPY 和 INSERT 批量写入有什么区别？
COPY 是底层数据流加载协议，INSERT 是 SQL 语句层操作，COPY 在大量数据场景下开销更低。
普通用户可以使用 COPY 命令吗？
客户端 COPY FROM STDIN 普通用户可用，服务端 COPY FROM 'file' 通常需要超级用户权限。
导入过程中断数据会保留吗？
COPY 命令在一个事务中运行，中途失败会自动回滚，不会保留部分数据。
参考来源
- PostgreSQL Official Documentation, COPY, https://www.postgresql.org/docs/current/sql-copy.html