NAME

COPY - 在表和文件之间拷贝数据

SYNOPSIS

COPY tablename [ ( column [, ...] ) ]


    FROM { 'filename' | STDIN }


    [ [ WITH ] 


          [ BINARY ] 


          [ OIDS ]


          [ DELIMITER [ AS ] 'delimiter' ]


          [ NULL [ AS ] 'null string' ] ]
COPY tablename [ ( column [, ...] ) ]


    TO { 'filename' | STDOUT }


    [ [ WITH ] 


          [ BINARY ]


          [ OIDS ]


          [ DELIMITER [ AS ] 'delimiter' ]


          [ NULL [ AS ] 'null string' ] ]

DESCRIPTION 描述

COPY 在 PostgreSQL表和标准文件系统文件之间交换数据。 COPY TO 把一个表的所有内容都拷贝到一个文件， 而 COPY FROM 从一个文件里拷贝数据到一个表里（把数据附加到表中已经存在的内容里）。

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

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

PARAMETERS 参数

tablename

现存表的名字（可以有模式修饰）。

column

可选的待拷贝字段列表。如果没有声明字段列表，那么将使用所有字段。

filename

输入或输出文件的绝对路径名。

STDIN

声明输入是来自客户端应用。

STDOUT

声明输入前往客户端应用。

BINARY

使用二进制格式存储和读取，而不是以文本的方式。 在二进制模式下，不能声明 DELIMITERS和NULL。

OIDS

声明为每行拷贝内部对象标识（OID）。 （如果给那些没有 OID 的表声明了 OIDS 选项，则抛出一个错误。）

delimiter

用于在文件中每行中分隔各个字段的单个字符。 缺省是水平制表符。（tab）

null string

一个代表 NULL 值的字串。缺省是 \N （反斜杠-N）。 当然，你可以自己挑一个空字串。

NOTES 注意

COPY 只能用于表，不能用于视图。

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

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

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

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

我们建议在 COPY 里的文件名字总是使用绝对路径。 在 COPY TO 的时候是由服务器强制进行的， 但是对于 COPY FROM，你的确有从一个声明为相对路径的文件里读取的选择。 该路径将解释为相对于服务器的工作目录（在数据目录里的什么地方），而不是客户端的工作目录。

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

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

FILE FORMATS 文件格式

EXAMPLES 例子

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

COPY country TO STDOUT WITH DELIMITER '|';

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

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

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

AF      AFGHANISTAN
AL      ALBANIA
DZ      ALGERIA
ZM      ZAMBIA
ZW      ZIMBABWE

下面的是同样的数据，在一台 Linux/i586 机器上以二进制形式输出。 这些数据是用 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

COMPATIBILITY 兼容性

在 SQL 标准里没有 COPY 语句。

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' ]

译者

Postgresql 中文网站 何伟平 <laser@pgsqldb.org>

跋

本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划：https://github.com/man-pages-zh/manpages-zh