PostgreSQL / 系统课时

使用 COPY 导入数据

使用 COPY 导入数据

本课解决“如何把大量结构化数据高效导入 PostgreSQL”的问题。你将分别使用服务端 COPY 和客户端 psql \copy,并掌握 CSV 表头、空值、文件路径与权限的关键差异。

学习目标

  • 使用 COPY FROM 导入 CSV 数据
  • 理解 COPY 与 \copy 的执行位置
  • 能验证导入数量并定位常见失败

COPY 与 \copy 的区别

COPY 是 PostgreSQL SQL 命令。COPY FROM '文件路径' 由数据库服务器进程读取文件,因此路径必须是服务器可见的绝对路径,并且数据库进程需要读取权限;通常还需要超级用户或相应服务器文件读取角色。

\copy 是 psql 元命令,由运行 psql 的客户端读取本地文件,再通过数据库连接传输数据。开发机导入本地 CSV 时,\copy 通常更方便。

准备表和 CSV 文件

先在数据库中创建目标表:

sql
DROP TABLE IF EXISTS demo_products;

CREATE TABLE demo_products (
    sku TEXT PRIMARY KEY,
    name TEXT NOT NULL,
    price NUMERIC(10, 2) NOT NULL,
    stock INTEGER
);

预期结果

text
DROP TABLE
CREATE TABLE

然后在客户端当前目录创建 products.csv,内容如下:

text
sku,name,price,stock
P001,键盘,199.00,20
P002,鼠标,89.90,35
P003,显示器,1299.00,

空白 stock 将按后续命令中的空值规则导入为 NULL。

使用 psql 的 \copy 导入

在 psql 交互终端中执行:

sql
\copy demo_products (sku, name, price, stock)
FROM 'products.csv'
WITH (
    FORMAT csv,
    HEADER true,
    NULL ''
);

预期结果

text
COPY 3

随后验证数据:

sql
SELECT sku, name, price, stock
FROM demo_products
ORDER BY sku;

预期结果

text
 sku  |  name  |  price  | stock
------+--------+---------+-------
 P001 | 键盘   |  199.00 |    20
 P002 | 鼠标   |   89.90 |    35
 P003 | 显示器 | 1299.00 |
(3 rows)

不同终端对中文列宽和 NULL 的显示可能略有差异,但数据值应一致。

使用服务端 COPY

当 CSV 已经位于数据库服务器,并且权限满足要求时,可以执行:

sql
COPY demo_products (sku, name, price, stock)
FROM '/products.csv'
WITH (
    FORMAT csv,
    HEADER true,
    NULL ''
);

这是片段示例,其中 必须替换为数据库服务器上的绝对目录。成功后返回 COPY 3;若重复导入同一文件,会因 sku 主键冲突而失败。

服务端导出也可使用 COPY TO,客户端导出则使用 \copy ... TO。两者的核心差异仍是文件由服务器还是客户端访问。

常见失败与处理

出现“文件不存在”时,先确认使用的是 COPY 还是 \copy,并检查路径属于服务器还是客户端。出现“权限不足”时,优先改用 \copy,或由管理员安全配置服务器文件读取权限。

数据类型错误会中止整条 COPY,例如 price 中出现无法转换的文本。导入前应检查 CSV 编码、分隔符、引号、列顺序和空值格式。正式导入时可先写入临时表,再校验并转换到业务表。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 COPY 导入数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通