PostgreSQL copy 命令教程详解

报文介绍PostgreSQL copy 命令，通过示例展示把查询结果导出到csv文件，导入数据文件至postgresql。

1. copy命令介绍

copy命令用于在postgreSql表和标准文件系统直接传输数据。copy命令让PostgreSQL 服务器直接读写文件，因此文件必须让PostgreSQL 用户能够访问到。该命令使用的文件是数据库服务器直接读写的文件，不是客户端应用的文件，因此必须位于服务器本地或被直接访问的文件，而不是客户端位置。

copy to 命令拷贝表内容至文件，也可以拷贝select的查询结果；也就说，如果select后面列出部分字段，则copy to 命令仅拷贝指定字段的结果至文件。准备使用copy to 命令的表必须授予select权限。该命令仅能在表上使用，不能用于视图；当我们需要拷贝视图内容时，可以给copy命令传入sql查询：

COPY (SELECT * FROM country) TO ‘list_countries.copy';

copy from拷贝文件的数据到数据表。当使用copy from，文件中的每个字段被i顺序插入特定字段。如果该命令中的表的列参数未指定则获取它们的缺省值。使用copy from命令的表必须授予insert权限。

不要混淆copy命令和psql中的 \copy。\copy调用 COPY FROM STDIN 或 COPY TO STDOUT，然后返回数据或存储可以被psql客户端访问的文件数据。因此，当使用\copy时，文件的可访问性和访问权限取决于客户端，而不是服务器。

2. copy命令示例

2.1 从Postgresql导出表

我们能拷贝表至控制台，并使用竖线(|)作为字段直接的分隔符：

copy customers to stdout(delimiter '|')

拷贝表至文件，使用空格作为字段直接的分隔符：

COPY customers TO '/database/data/test_data.copy' (DELIMITER ' ');

2.2 导入文件至Postgresql表

传入文件至已经存在的表：

COPY customers FROM '/database/data/test_data.copy' (DELIMITER ' ');

2.3 导出查询结果至文件

导出查询结果至文件：

COPY (SELECT * FROM customers WHERE name LIKE 'A%') TO '/data/test_data.copy';

如果需要压缩数据，使用下面命令：

COPY customers TO PROGRAM 'gzip > /data/test_data.copy.gz';

如果仅导出2列，使用下面命令：

COPY customers(col, col2) TO '/data/test_data.copy' DELIMITER ' ';

如果需要导出二进制文件：

copy customers to 'e:/data.dat' with binary;

导出csv文件：

copy customers to 'e:/data.csv' with csv;

csv文件还有一些其他参数：

DELIMITER – 数据行中分割每个字段的分隔符。csv文件一般使用逗号.

HEADER – 指定csv文件的标题，如果不需要标题行，可以忽略HEADER.

COPY country FROM '/data/test_data.copy' WITH delimiter ',' CSV HEADER;

指定编码：

COPY country FROM '/data/test_data.copy' WITH delimiter ',' CSV HEADER encoding 'utf-8';

3. 总结

本文介绍PostgreSQL中的copy命令，并通过示例展示了不同的应用场景。使用COPY加载大量行总是比使用INSERT快，COPY会进行一次设置,并且每行的开销都非常低,尤其是在不涉及触发器的情况下。