在 Windows 环境下高效导出 PostgreSQL 数据的最佳实践

Hello.Reader

于 2025-04-23 07:00:00 发布

阅读量1k

点赞数 22

本文链接：https://blog.csdn.net/weixin_43114209/article/details/147433690

版权

数据库专栏收录该内容

25 篇文章

订阅专栏

一、环境准备

确认 PostgreSQL 安装目录
通常位于：

C:\Program Files\PostgreSQL\<版本号>\bin

（可选）将 bin 添加到系统 PATH
- 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”
- 在“系统变量”中编辑 Path，新增：
```
C:\Program Files\PostgreSQL\<版本号>\bin
```
这样即可在任意命令行窗口直接使用 pg_dump、psql 等工具。
确认客户端编码
如果数据库使用 UTF‑8，确保命令行窗口和文件保存也是 UTF‑8，以免出现中文乱码。

二、整库导出

2.1 导出为纯 SQL 脚本

将整库导出成一份可读的 SQL 文本，适合审阅或手动微调：

pg_dump -U postgres -h localhost -p 5432 \
    -F p \
    -f "C:\backup\mydb.sql" \
    mydb

-F p：plain 文本格式
-f：指定输出文件路径
mydb：数据库名

2.2 导出为自定义二进制格式

自定义格式支持并行恢复、高效压缩，推荐生产环境备份：

pg_dump -U postgres -h localhost -p 5432 \
    -F c -b -v \
    -f "C:\backup\mydb.backup" \
    mydb

-F c：custom 格式（.backup）
-b：包含大对象（BLOBs）
-v：显示详细执行过程

恢复命令：

pg_restore -U postgres -h localhost -p 5432 \
    -d targetdb -v \
    "C:\backup\mydb.backup"

三、单表或部分数据导出

有时只需导出特定表或筛选后的数据，避免冗余导出、加快速度。

3.1 导出单表模式（DDL）

只导出表结构，不包含数据：

pg_dump -U postgres -h localhost -p 5432 \
    -F p -s -t schema.table_name \
    -f "C:\backup\table_schema.sql" \
    mydb

-s/--schema-only：仅导出模式

3.2 导出单表数据（DML）

只导出表中数据，不含建表语句：

pg_dump -U postgres -h localhost -p 5432 \
    -F p -a -t schema.table_name \
    -f "C:\backup\table_data.sql" \
    mydb

-a/--data-only：仅导出数据

3.3 导出表结构＋数据

同时导出模式与数据，适合局部迁移：

pg_dump -U postgres -h localhost -p 5432 \
    -F p -t schema.table_name \
    -f "C:\backup\table_full.sql" \
    mydb

四、导出为 CSV

对于数据分析、报表、ETL 场景，CSV 格式是最常用的轻量化选择。

4.1 使用 `psql \copy`

\copy 在客户端执行，避免服务器文件权限问题：

psql -U postgres -h localhost -p 5432 -d mydb \
  -c "\copy schema.table_name TO 'C:\\backup\\table.csv' WITH CSV HEADER"

WITH CSV HEADER：第一行包含列名
本地路径需双反斜杠 \\

4.2 导出查询结果

仅导出符合条件的数据集：

psql -U postgres -h localhost -p 5432 -d mydb \
  -c "\copy (SELECT id,name,created_at FROM schema.table_name WHERE status='active') \
      TO 'C:\\backup\\active_users.csv' WITH CSV HEADER"