pg_dump

PostgreSQL 逻辑备份工具

补充说明

pg_dump 把单个数据库导出成 SQL 脚本或归档文件，是逻辑备份的主要工具。它导出的是某一时刻的一致性快照，但不包含全局对象（角色、表空间）和 pg_dumpall 才处理的集群级信息。

常用示例

pg_dump -h 127.0.0.1 -U app -d appdb > appdb.sql
pg_dump -Fc -d appdb -f appdb.dump          # 自定义格式，可并行恢复
pg_dump -Fd -j 4 -d appdb -f appdb.dir      # 目录格式，并行导出
pg_dump -d appdb -t orders -f orders.sql
pg_dump -d appdb -n public -N audit -f app.sql
pg_dump -d appdb -s -f schema.sql           # 只导结构
pg_dump -d appdb -a -f data.sql             # 只导数据
pg_dump -Fc -Z 6 -d appdb -f appdb.dump     # 压缩

易错点与排错

• 版本不匹配会失败或丢对象；用与目标库同版本或更新的 pg_dump，不要用旧版本客户端。
• -Fc/-Fd 必须用 pg_restore 恢复；纯 SQL 文件才用 psql -f。
• 默认不导出大对象；需要时加 -b。
• 备份期间的 DDL 变更可能让快照不一致；业务低峰执行，或用 --snapshot 配合。
• 只导表结构加 -s，只导数据加 -a；两者都不加才是完整备份。
• -t 只匹配表名，不会自动带上依赖的序列/索引；恢复后检查默认值和序列。
• 权限、扩展、owner 默认会写入 dump；跨环境恢复常用 --no-owner --no-privileges。
• 大库不要直接落到 stdout 再重定向；-Fd -j 更快且便于校验。
• 备份文件要校验可恢复性；只生成不演练等于没有备份。

相关命令

• pg_restore — 恢复 -Fc/-Fd 备份
• pg_basebackup — 物理备份
• psql — 执行纯 SQL 备份