COPY

描述

COPY 在表和文件之间交换数据。COPY TO 把一个表的所有内容都拷贝到一个文件，而 COPY FROM 从一个文件里拷贝数据到一个表里(把数据附加到表中已经存在的内容里)。COPY TO 还能拷贝 SELECT 查询的结果。

如果声明了一个字段列表，COPY 将只在文件和表之间拷贝已声明字段的数据。如果表中有任何不在字段列表里的字段，那么 COPY FROM 将为那些字段插入缺省值。

带文件名的 COPY 指示 PostgreSQL 服务器直接从文件中读写数据。如果声明了文件名，那么服务器必须可以访问该文件，而且文件名必须从服务器的角度声明。如果指定了 STDIN 或 STDOUT ，那么数据将在客户前端和服务器之间流动。

参数

输出

成功完成时，COPY 按照如下格式返回一个命令标签：

COPY count

其中的 count 是拷贝的行数。

注意

COPY 只能用于表，不能用于视图。当然也可以用于 COPY (SELECT * FROM viewname) TO ...

BINARY 关键字将强制使用二进制对象而不是文本存储/读取所有数据。这样做在一定程度上比传统的拷贝命令快，但二进制拷贝文件在不同机器体系和 PostgreSQL 版本之间的移植性不是很好。

你对任何要 COPY TO 出来的数据必须有选取数据的权限，对任何要 COPY FROM 入数据的表必须有插入权限。

COPY 命令里面的文件必须是由服务器直接读或写的文件，而不是由客户端应用读写。因此，它们必须位于数据库服务器上或者可以被数据库服务器所访问，这些事情不应该由客户端来做。它们必须被运行 PostgreSQL 服务器的用户可读或写，而不是客户端。只允许数据库超级用户 COPY 一个文件，因为它允许读写任意服务器有权限访问的文件。

不要混淆 COPY 和 psql 的 \copy 指令。\copy 调用 COPY FROM STDIN 或 COPY TO STDOUT ，然后把数据抓取/存储到一个 psql 客户端可以访问的文件中。因此，使用 \copy 的时候，文件访问权限是由客户端而不是服务器端决定的。

建议在 COPY 里的文件名字总是使用绝对路径。在 COPY TO 的时候是由服务器强制进行的，但是对于 COPY FROM ，你的确可从一个相对路径的文件里读取。该路径将解释为相对于服务器的工作目录(通常是数据目录)，而不是客户端的工作目录。

COPY FROM 会激活所有触发器和检查约束。不过，不会激活规则。

COPY 输入和输出被 DateStyle 影响。为了和其它 PostgreSQL 安装移植(它们可能是非缺省 DateStyle 设置)，应该在使用 COPY TO 前把 DateStyle 设置为 ISO 。

COPY 在第一个错误处停下来。这些在 COPY TO 中不应该导致问题，但在 COPY FROM 时目标表会已经接收到早先的行，这些行将不可见或不可访问，但是仍然会占据磁盘空间。如果你碰巧拷贝大块数据文件的话，这些东西积累起来可能会占据相当大的磁盘空间。你可以调用 VACUUM 来恢复那些磁盘空间。

文件格式

例子

下面的例子把一个表拷贝到客户端，使用竖直条(|)作为域分隔符：

COPY country TO STDOUT WITH DELIMITER '|';

从文件中拷贝数据到 country 表中：

COPY country FROM '/usr1/proj/bray/sql/country_data';

使用一个会被自动删除的临时表，把'A'开头的国家名拷贝到一个文件里：

COPY (SELECT * FROM country WHERE country_name LIKE 'A%') TO '/usr1/proj/bray/sql/a_list_countries.copy';

下面是一个可以从 STDIN 中拷贝数据到表中的例子：

AF      AFGHANISTAN
AL      ALBANIA
DZ      ALGERIA
ZM      ZAMBIA
ZW      ZIMBABWE

注意，每行里的空白实际上是一个水平制表符。

下面的是同样的数据，以二进制形式输出。这些数据是用 Unix 工具 od -c 过滤之后输出的。该表有三个字段；第一个是 char(2) ，第二个是 text ，第三个是 integer 。所有的行在第三个域都是一个 null 值。

0000000   P   G   C   O   P   Y  \n 377  \r  \n  \0  \0  \0  \0  \0  \0
0000020  \0  \0  \0  \0 003  \0  \0  \0 002   A   F  \0  \0  \0 013   A
0000040   F   G   H   A   N   I   S   T   A   N 377 377 377 377  \0 003
0000060  \0  \0  \0 002   A   L  \0  \0  \0 007   A   L   B   A   N   I
0000100   A 377 377 377 377  \0 003  \0  \0  \0 002   D   Z  \0  \0  \0
0000120 007   A   L   G   E   R   I   A 377 377 377 377  \0 003  \0  \0
0000140  \0 002   Z   M  \0  \0  \0 006   Z   A   M   B   I   A 377 377
0000160 377 377  \0 003  \0  \0  \0 002   Z   W  \0  \0  \0  \b   Z   I
0000200   M   B   A   B   W   E 377 377 377 377 377 377

兼容性

SQL 标准里没有 COPY 语句。

PostgreSQL 7.3 以前使用下面的语法，现在仍然支持：

COPY [ BINARY ] tablename [ WITH OIDS ]
    FROM { 'filename' | STDIN }
    [ [USING] DELIMITERS 'delimiter' ]
    [ WITH NULL AS 'null string' ]

COPY [ BINARY ] tablename [ WITH OIDS ]
    TO { 'filename' | STDOUT }
    [ [USING] DELIMITERS 'delimiter' ]
    [ WITH NULL AS 'null string' ]