PostgreSQL / 系统课时
使用 pg_dump 备份数据库
使用 pg_dump 备份数据库
pg_dump 用于导出单个 PostgreSQL 数据库的结构和数据。本课将完成纯文本与自定义格式备份,说明两种格式的差异,并通过读取文件或目录清单验证备份是否成功。
学习目标
- 使用
pg_dump创建单库逻辑备份 - 根据恢复方式选择纯文本或自定义格式
- 检查命令退出状态和备份内容
备份前检查
执行备份的账号至少要能连接数据库并读取需要导出的对象。客户端 pg_dump 版本不能低于源数据库的主版本;跨大版本迁移时,通常使用目标环境对应版本的客户端工具,并先验证扩展兼容性。
先确认工具和连接可用。密码应通过 .pgpass、受控环境变量或交互方式提供,不要直接写入脚本。
pg_dump --version
psql -h <HOST> -p <PORT> -U backup_user -d appdb -c "select current_database(), current_user;"预期输出
pg_dump (PostgreSQL) <VERSION>
current_database | current_user
------------------+-------------
appdb | backup_user
(1 row)<HOST>、<PORT> 和 <VERSION> 会随实际环境变化。
创建纯文本备份
纯文本格式本质上是一份可由 psql 执行的 SQL 脚本,适合阅读、审查和简单迁移。使用 -Fp 明确指定 plain 格式,-f 指定输出文件。
pg_dump -h <HOST> -p <PORT> -U backup_user -d appdb -Fp --no-owner --no-privileges -f appdb.sql
test -s appdb.sql
head -n 5 appdb.sql预期输出
--
-- PostgreSQL database dump
--test -s 没有输出且退出码为 0,表示文件存在并且非空。--no-owner 和 --no-privileges 便于恢复到角色名称不同的环境,但不会保留原属主与授权关系。
创建自定义格式备份
自定义格式由 pg_restore 读取,支持按对象选择、重排和并行恢复,通常更适合正式备份与迁移。
pg_dump -h <HOST> -p <PORT> -U backup_user -d appdb -Fc --no-owner --no-privileges -f appdb.dump
pg_restore --list appdb.dump | head预期输出
;
; Archive created at <TIME>
; dbname: appdb
; TOC Entries: <COUNT>
;时间与对象数量是动态值。只要 pg_restore --list 能正常列出目录且命令退出码为 0,就说明归档结构可读取;这仍不能替代真正的恢复演练。
选择格式与保存策略
纯文本备份只能按 SQL 顺序执行,难以只恢复某个对象,也不能并行加载。自定义格式更灵活,但不能直接用文本编辑器查看,必须通过 pg_restore 操作。
无论选择哪种格式,都应把数据库名、备份时间、工具版本和校验值写入清单,并将文件复制到独立故障域。逻辑备份不包含角色和表空间等全局对象,这些内容需要单独导出。
常见失败处理
出现 permission denied for table 时,应补充只读权限或调整备份范围;出现版本不兼容时,应更换合适版本的 pg_dump;备份过程中连接中断时,必须删除不完整文件并重新执行,不能把“文件已生成”视为成功。
脚本应检查命令退出码,并在成功后再生成校验值。
set -euo pipefail
pg_dump -h <HOST> -p <PORT> -U backup_user -d appdb -Fc -f appdb.dump
sha256sum appdb.dump > appdb.dump.sha256
sha256sum -c appdb.dump.sha256预期输出
appdb.dump: OK