• 浏览分类
• 随机条目
• PgPedia 周刊
  • 2024-07-14
• 这一天…
• PostgreSQL 版本
  • PostgreSQL 18 (开发中)
  • PostgreSQL 17 (beta3)
  • PostgreSQL 16 (最新)
  • PostgreSQL 15
  • PostgreSQL 14
  • PostgreSQL 13
  • PostgreSQL 12
  • PostgreSQL 11 (已结束支持)

版本图表

有用概述

有用链接

咖啡

复制

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

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 17
  • 为 COPY FROM 添加了 FORCE_NULL * 和 FORCE_NOT_NULL * 选项（提交 f6d4c9cf）
  •  添加了 ON_ERROR 选项以用于 COPY FROM（初始提交 9e2d8701，在 b725b7ee 中从 SAVE_ERROR_TO 重命名）
  • 添加了 LOG_VERBOSITY 选项（提交 f5a22789）
• PostgreSQL 16
  • 启用了批量插入到 外部表 中（提交 97da4824）
  • 为 COPY FROM 添加了 DEFAULT 选项（提交 9f8377f7）
• PostgreSQL 15
  • HEADER 选项现在可用于 FORMAT 选项 text（提交 43f33dc0）
  • 为 COPY FROM 添加了 HEADER MATCH 选项（提交 072132f0）
• PostgreSQL 14
  • 通过改进的缓冲提高了性能（提交 0a0727cc）
  • 通过 pg_stat_progress_copy 进行进度跟踪（提交 8a4f618e）
• PostgreSQL 12
  • 现在可以向 COPY FROM 添加 WHERE 子句，从而可以过滤传入的数据（提交 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

参考文献

有用链接

分类

另请参阅

反馈