pg_restore

恢复 PostgreSQL 逻辑备份

补充说明

pg_restore 读取 pg_dump -Fc、-Fd 或 -Ft 生成的归档，能选择对象、并行恢复。纯 SQL 文件不归它管，应该交给 psql。

常用示例

pg_restore -d appdb appdb.dump
pg_restore -l appdb.dump > list.txt          # 查看归档内容
pg_restore -L list.txt -d appdb appdb.dump   # 按清单选择性恢复
pg_restore -j 4 -d appdb appdb.dir          # 目录格式并行恢复
pg_restore -d appdb --clean --if-exists appdb.dump
pg_restore -d appdb -n public -t orders appdb.dump
pg_restore --no-owner --no-privileges -d appdb appdb.dump

易错点与排错

• 纯 SQL 备份用 psql -f；拿 pg_restore 打开会报不是归档格式。
• 默认遇到错误会继续，退出码仍可能是 0；加 --exit-on-error 才能在脚本里可靠判断。
• -j 不能和 --single-transaction 同时用；并行恢复只支持目录格式。
• --clean 会先删对象，属于破坏性操作；先 --dry-run 或恢复到临时库验证。
• 目标库不存在时不会自动创建；先 createdb，或用 -C 让归档里的库名生效。
• 扩展、角色、表空间可能不存在；跨环境常用 --no-owner --no-privileges 并手动补扩展。
• 恢复顺序和依赖由归档决定；只用 -t 时不会自动带上依赖对象。
• 并行度不是越高越好；受磁盘、锁和 CPU 限制，先小规模压测。

相关命令

• pg_dump — 生成归档
• psql — 执行 SQL 备份
• createdb — 准备目标库