• 浏览分类
• 随机条目
• PgPedia周刊
  • 2025-10-05
• 25年前的今天
• PostgreSQL版本发布
  • PostgreSQL 19 (开发中)
  • PostgreSQL 18 (最新)
  • PostgreSQL 17
  • PostgreSQL 16
  • PostgreSQL 15
  • PostgreSQL 14
  • PostgreSQL 13
  • PostgreSQL 12 (已停止支持)

版本图表

实用概述

有用链接

咖啡

COPY

COPY 是一个 DML 命令，用于将数据批量导入/导出到/从文件，或者（从 PostgreSQL 9.3 开始）到/从程序。

COPY 始终存在于 PostgreSQL 中。

限制

COPY 仅限于 PostgreSQL 运行所在的宿主操作系统上，其操作系统用户允许的操作。

从 PostgreSQL 11 开始，COPY 对超级用户和以下 预定义角色的成员可用。

• pg_read_server_files
• pg_write_server_files
• pg_execute_server_program

在 PostgreSQL 10 及更早版本中，COPY 的使用仅限于超级用户。

进度报告

从 PostgreSQL 14 开始，进度报告视图 pg_stat_progress_copy 提供了关于 COPY 操作进度的信息。

psql

psql 提供了斜杠命令 \copy，该命令支持 COPY 操作在客户端系统和服务器之间进行（克服了 SQL COPY 命令仅限于本地服务器的限制）。

更多详情，请参阅 psql 文档： \copy。

变更历史

进行中

• PostgreSQL 19
  • 支持在 COPY FROM 中使用多行头（提交 bc2f348e）
• PostgreSQL 18
  • 在 CSV 模式下使用 COPY FROM 时，\. 不再被视为 EOF 标记（提交 77023374）
  • 在选项 LOG_VERBOSITY 中添加了 silent 设置（提交 e7834a1a）
  • 为 COPY FROM 添加了 REJECT_LIMIT 选项（提交 4ac2a9be）
  • 现在拒绝在 外表上执行 COPY FREEZE（提交 401a6956）
  • COPY TO 可以从物化视图复制行（提交 534874fa）
• PostgreSQL 17
  • 为 COPY FROM 添加了 FORCE_NULL * 和 FORCE_NOT_NULL * 选项（提交 f6d4c9cf）
  • 为 COPY FROM 添加了 ON_ERROR 选项（初始提交 9e2d8701，在 b725b7ee 中重命名为 SAVE_ERROR_TO）
  • 添加了 LOG_VERBOSITY 选项（提交 f5a22789）
• PostgreSQL 16
  • 启用了向 外表进行批量插入（提交 97da4824）
  • 为 COPY FROM 添加了 DEFAULT 选项（提交 9f8377f7）
• PostgreSQL 15
  • 对于 FORMAT 选项 text，现在可以使用 HEADER 选项（提交 43f33dc0）
  • 为 COPY FROM 添加了 HEADER MATCH 选项（提交 072132f0）
• PostgreSQL 14
  • 通过改进缓冲提高了性能（提交 0a0727cc）
  • 通过 pg_stat_progress_copy 进行进度跟踪（提交 8a4f618e）
• PostgreSQL 12
  • 现在可以将 WHERE 子句添加到 COPY FROM 中，从而可以过滤传入的数据（提交 31f38174）
  • 通过使用多重插入，加快了向 分区表 的插入速度（提交 0d5f05cd）
• PostgreSQL 11
  • 如果底层 外部数据包装器支持，则 COPY 可用于 外表和外部分区（提交 3d956d95）
  • COPY 也可以由 默认角色 pg_read_server_files、pg_write_server_files 和 pg_execute_server_program 的成员执行（提交 0fdc8495）
• PostgreSQL 10
  • COPY view FROM 现在可以插入到定义了 INSTEAD OF INSERT 触发器的视图中（提交 279c439c）
• PostgreSQL 9.6
  • COPY 现在可以复制 INSERT/UPDATE/DELETE ... RETURNING 查询的输出（提交 92e38182）
• PostgreSQL 9.4
  • 添加了 FORCE NULL 选项（提交 3b5e03dc）
  • 对带有 DEFAULT nextval() 的表执行 COPY 操作已加速（提交 4d1e2aeb）
• PostgreSQL 9.3
  • 添加了读/写程序的功能（COPY ... [FROM | TO] PROGRAM）（提交 3d009e45）
  • 添加了 COPY FREEZE 选项（提交 8de72b66）
  • 通过 SPI 可获取 COPY 处理的行数（提交 7ae18159）
  • 通过 PL/pgSQL 中的 GET DIAGNOSTICS x = ROW_COUNT 可获取 COPY 处理的行数（提交 7ae18159）
• PostgreSQL 9.1
  • 添加了 ENCODING 选项（提交 3cba8240）
• PostgreSQL 8.2
  • 添加了 COPY (SELECT ...) TO ... 语法（提交 85188ab8）
• PostgreSQL 8.0
  • 添加了 CSV 选项（提交 862b20b3）
• PostgreSQL 7.4
  • 现在可以从 COPY 操作中干净退出（提交 ea20397b）
  • 现在允许 COPY 文件使用 \r 和 \r\n 作为行终止符（提交 c3b7d2d5）
  • 现在可以处理包含转义的 \r 和 \r\n 序列的文件（提交 c3b7d2d5）
• PostgreSQL 7.3
  • 通过 WITH 子句标准化了选项处理（提交 c2c2fd57）
  • 可以为输入和输出操作指定单个表列（提交 a90db34b）
  • 如果未为输入操作指定表列，且源数据不包含所有表列，则会引发错误（提交 874148fe）
  • COPY TO 将嵌入的回车符和换行符输出为 \r 和 \n（提交 9832a235）
  • DELIMITER 字符串可以是 8 位字符（提交 21f9a654）
• PostgreSQL 7.2
  • 不再可能对视图执行 COPY TO/COPY FROM（提交 b6564c44）
  • DELIMITER 字符串必须是 1 个字符（提交 969cc16c）
• PostgreSQL 7.1
  • 二进制复制模式的新文件格式（提交 676cf18c）
• PostgreSQL 7.0
  • USING 关键字变为可选（提交 60f3e6b3）
  • 添加了 WITH NULL AS 'null string' 选项（提交 bcaabc56）
• PostgreSQL 6.3
  • 失败时报告行号（提交 deea69b9）

示例

postgres=# COPY foo FROM STDIN;
Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal.
>> 1
>> 2
>> 3
>> 4
>> \.
COPY 4

参考资料

有用链接

分类

另请参阅

反馈