table_name

现存表的名字(可以有模式修饰)。。

column_name

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

query

一个必须用圆括弧包围的SELECT或VALUES命令，其结果将被拷贝。

filename

输入或输出文件的路径名。输入文件名可以是绝对或是相对的路径，但输出文件名必须是绝对路径。 Windows用户可能需要使用E''字符串和双反斜线作为路径名称。

PROGRAM

需执行的程序名。在COPY FROM命令中，输入是从程序的标准输出中读取，而在COPY TO中，命令的输出会作为程序的标准输入。

注意，程序一般是在命令行界面下执行，当用户需要传递一些变量给程序时，如果这些变量的来源不是可靠的，用户必须小心过滤处理那些对命令行界面来说是有特殊意义的字符。 基于安全的原因，最好是使用固定的命令字符串，或者至少是应避免直接使用用户输入（应先过滤特殊字符）。

STDIN

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

STDOUT

声明输入将写入客户端应用。

boolean

声明用户所选的选项是否应该被开启或者关闭。您可以写TRUE、 ON或1来启用这个选项，并且用FALSE、OFF或0来关闭它。 boolean值也可以被省略，此时系统使用缺省值TRUE。

FORMAT

选择被读或者写的数据格式：text、csv（逗号分隔值），或者binary。 默认是text。

OIDS

声明为每行记录都拷贝内部对象标识(OID)。 （如果为一个query拷贝或者没有OIDS的表声明了OIDS选项，则抛出一个错误。）

FREEZE

请求拷贝那些已冻结的数据，就类似使用VACUUM FREEZE的效果。 这主要于用于初始化时加载数据时的性能考虑。 仅在表记录初始创建或是在当前子事务中被清理的记录会补冻结，没有游标会打开，事务中也没有数据快照。

注意此时其他的事务会立刻看见刚加载的数据。 这不符合MVCC正常的可见性规则，用户应注意这可能带来的潜在问题。

DELIMITER

指定分隔每一行记录中的列的字符。默认是文本格式的制表符，CSV格式的逗号。 必须有一个独立的一字节的字符。 在使用binary格式时这个选项是不允许的。

NULL

声明代表一个空值的字符串。默认是文本格式的\N，CSV格式的一个未被引用的空字符串。 即使是文本格式您可能也更偏向于空串，例如您不想从空字符串中区分空值。 在使用binary格式时这个选项是不允许的。

注意: 在使用COPY FROM的时候，任何匹配这个字符串的字符串将被存储为NULL值，所以你应该确保你用的字符串和COPY TO相同。

HEADER

声明文件包含一个带有文件中每列名称的标题行。 在输出时，第一行包含表中的列名，在输入时，第一行是被忽略的。该选项仅仅在使用CSV格式时是允许的。

QUOTE

指定引用数据的引用字符。默认的是双引号。这一定是一个1字节的字符。该选项仅仅在使用CSV格式时允许。

ESCAPE

声明应该出现在一个匹配QUOTE值的数据字符之前的字符。 默认与QUOTE值相同（所以若它出现在数据中，则引用字符是翻一倍）。 这一定是一个1字节的字符。该选项只有在使用CSV格式时允许。

FORCE_QUOTE

强制引用在每个指定列的所有非NULL值。NULL从不被引用。 如果声明了*，非NULL值将在所有列中被引用。 这个选项仅仅在COPY TO中并且仅仅在使用CSV格式时允许。

FORCE_NOT_NULL

默认情况下空字符串是空的，这意味着空值将会被读作长度为零的字符串而不是空值，即使当他们不被引用。 这个选项仅仅在COPY FROM中并且仅仅在使用CSV格式时允许。

ENCODING

声明文件的编码集是encoding_name。 如果这个选项省略，则系统使用当前的用户编码集。 阅读下面的注意事项以了解更多内容。

文本格式

当使用text格式时，读写的文件是一个文本文件，每行代表表中一个行。 行中的列(字段)用分隔符分开。字段值本身是由与每个字段类型相关的输出函数生成的字符串，或者是输入函数可接受的字符串。 数据中使用特定的NULL字符串表示那些值为NULL的字段。 如果输入文件的任意行包含比预期多或者少的字段，那么COPY FROM将抛出一个错误。 如果声明了OIDS选项，那么OID将作为第一个字段读写，放在所有用户字段前面。

数据的结束可以用一个只包含反斜杠和句点(\.)的行表示。 如果从文件中读取数据，那么数据结束的标记是不必要的，因为文件结束符可以起到相同的作用； 但是在3.0之前的客户端协议里， 如果在客户端应用之间拷贝数据，那么必须要有结束标记。

反斜杠字符(\)可以用于COPY数据，来引用那些可能会被当作行或列分隔符的数据字符。 特别是以下字符，若以一列值的一部分出现则必须在前面加上反斜杠：反斜杠、换行符、回车以及当前的分隔符字符。

声明的空字符串被COPY TO不加任何反斜杠发送； 与之相对，COPY FROM在删除反斜杠之前拿它的输入与空字符串比较。 因此，像\N这样的空字符串不会和实际数据值\N之间混淆(因为后者会表现成\\N)。

COPY FROM能够识别下列特殊反斜杠字符：

目前，COPY TO绝不会发出一个八进制或者十六进制反斜杠序列，但是它的确使用了上面列出的其它字符用于控制字符。

任何其他未在上表中提及的斜字符将会用来表示其本身。然而，也要注意不必要的情况添加反斜杠。 因为这可能意外地生成一个匹配数据结束标记(\.)或者空字符串 (默认为\N）的字符串。 这些字符串将在任何其他反斜杠处理做完之前确认。

强烈建议产生COPY数据的应用程序将数据换行符和回车分别转换为 \n和\r序列。 目前，可以由反斜杠和回车代表一个数据回车，并且由反斜杠和换行符代表一个数据换行。 然而，这些表示法在将来的版本中可能无法接受。COPY文件在不同操作系统之间转移时，它们也非常容易被误解读， （例如：从Unix 系统移到Windows系统，或者反过来）。

COPY TO将在每行的结尾用一个Unix风格的换行符("\n")。 运行在Windows上的服务器会输出的回车换行符("\r\n")，但只是用于COPY到服务器 文件里； 为了在不同平台之间一致，COPY TO STDOUT总是发送"\n"而不管服务器平台是什么。 COPY FROM可以处理那些以回车符、换行符、回车/换行符作为行结束的数据。 为了减少在数据中出现的未转义的新行或者回车导致的错误，如果输入的行结尾不像上面这些符号，COPY FROM会发出警告。

CSV 格式

这个格式用于输入和输出逗号分隔数值(CSV)文件格式，许多其它程序都用这个文件格式，比如电子表格。 这个模式下生成并识别逗号分隔的CSV转义机制，而不是使用PostgreSQL标准文本的转义模式。

每条记录的值都是用DELIMITER字符分隔的。 如果数值本身包含分隔字符、QUOTE字符、NULL字符串、回车符、换行符，那么整个数值用QUOTE字符前缀和后缀(包围)， 并且数值里任何QUOTE字符或ESCAPE字符都前导转义字符。 你也可以使用FORCE_QUOTE在输出非NULL的指定字段值时强制引号包围。

CSV格式没有标准的办法区分一个NULL值和一个空字符串。 PostgreSQL的COPY通过引号包围来处理这些。 一个当作NULL 输出的NULL 参数值是没有引号包围的，而匹配非NULL字符串的参数值是用引号包围的。 比如，使用缺省设置时，一个NULL是写做一个无引号包围的空字符串，而一个空字符串数值写做 双引号包围("")。 读取数值也遵循类似的规则。 你可以使用FORCE_NOT_NULL来避免为特定字段进行NULL比较。

因为对于CSV格式而言，反斜杠不是特殊字符，数据的结束标志(\.) 可以作为数据值出现。 为了避免任何可能的歧意，一个单独的\.数据值在输出中将被自动使用引号包围； 在输入中，如果被引号界定，那么将不会当作数据结束标志。如果你要加载其它程序创建的、有未用引号界定字段的文件，并且其中含有\.值，你就必须用引号进行界定。

二进制格式

binary形式的选项会使得所有的数据被存储/读作二进制格式而不是文本。 这比文本和CSV格式的要快一些，但是一个二进制格式文件在机器架构和PostgreSQL版本之间的可移植性比较差。 另外，二进制格式是对数据类型有一定要求的；例如，不能从smallint列中输出二进制数据 并将二进制数据读入integer列，尽管在文本格式下那会运行良好。

binary文件格式包含一个文件头，0或更多包含行数据的元组，以及一个文件尾。头和数据按照网络字节顺序。

COPY country TO STDOUT (DELIMITER '|');

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

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

COPY country TO PROGRAM 'gzip > /usr1/proj/bray/sql/country_data.gz';

AF      AFGHANISTAN

AL      ALBANIA

DZ      ALGERIA

ZM      ZAMBIA

ZW      ZIMBABWE

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

COPY table_name [ ( column_name [, ...] ) ]

    FROM { 'filename' | STDIN }

    [ [ WITH ]

          [ BINARY ]

          [ OIDS ]

          [ DELIMITER [ AS ] 'delimiter' ]

          [ NULL [ AS ] 'null string' ]

          [ CSV [ HEADER ]

                [ QUOTE [ AS ] 'quote' ]

                [ ESCAPE [ AS ] 'escape' ]

                [ FORCE NOT NULL column_name [, ...] ] ] ]

COPY { table_name [ ( column_name [, ...] ) ] | ( query ) }

    TO { 'filename' | STDOUT }

    [ [ WITH ]

          [ BINARY ]

          [ OIDS ]

          [ DELIMITER [ AS ] 'delimiter' ]

          [ NULL [ AS ] 'null string' ]

          [ CSV [ HEADER ]

                [ QUOTE [ AS ] 'quote' ]

                [ ESCAPE [ AS ] 'escape' ]

                [ FORCE QUOTE { column_name [, ...] | * } ] ] ]

COPY [ BINARY ] table_name [ WITH OIDS ]

    FROM { 'filename' | STDIN }

    [ [USING] DELIMITERS 'delimiter' ]

    [ WITH NULL AS 'null string' ]

COPY [ BINARY ] table_name [ WITH OIDS ]

    TO { 'filename' | STDOUT }

    [ [USING] DELIMITERS 'delimiter' ]

    [ WITH NULL AS 'null string' ]