PostgreSQL 14 pg_dumpall 完整备份指南

pg_dumpall用于整实例备份（所有数据库、全局对象：角色、表空间、权限），区别于pg_dump只备份单个库。

⚠️ 必须使用postgres 超级用户执行

一、基础语法

pg_dumpall [选项] > 备份文件.sql

最简本地备份

pg_dumpall -U postgres > all_db_backup_$(date +%Y%m%d).sql

远程实例备份

pg_dumpall -h 192.168.1.100 -p 5432 -U postgres > all_backup.sql

二、常用核心参数（PG14 适用）

示例带清理语句：

pg_dumpall -U postgres -c -f all_backup.sql

三、密码免交互（推荐生产使用）

编辑~/.pgpass

localhost:5432:*:postgres:你的密码

授权（权限不对会失效）

chmod 600 ~/.pgpass

之后执行不需要输密码。

四、压缩备份（生产标准写法）

# 备份同时gzip压缩 pg_dumpall -U postgres | gzip > pg14_all_$(date +%Y%m%d).sql.gz # 解压恢复 gunzip -c pg14_all.sql.gz | psql -U postgres

五、恢复命令

整实例恢复（覆盖导入）

psql -U postgres -f all_backup.sql

重要提醒：

1. 恢复目标 PG 版本 ≥ 备份版本；PG14 的 dumpall 可以恢复到 14/15/16，不建议往更低版本恢复
2. 如果跨机器迁移：目标库不存在同名角色会报错，pg_dumpall 自带角色创建语句

六、生产定时备份脚本示例（可直接改造 crontab）

#!/bin/bash BACKUP_DIR="/data/pgbackup" DATE=$(date +%Y%m%d_%H%M%S) USER="postgres" mkdir -p ${BACKUP_DIR} pg_dumpall -U ${USER} | gzip > ${BACKUP_DIR}/pg14_all_${DATE}.sql.gz # 保留7天备份 find ${BACKUP_DIR} -name "pg14_all_*.sql.gz" -mtime +7 -delete

七、常见坑 PG14

1. pg_dumpall 不支持自定义格式（只能纯 sql 文本）如果你想要并行、压缩自定义格式，只能单库使用pg_dump -Fd；整实例只能 sql 脚本。
2. 大实例：pg_dumpall单进程，速度不如分库并行 pg_dump
3. 备份期间会获取共享快照，长时间备份存在长事务风险
4. 逻辑备份≠物理备份，超大库优先考虑pg_basebackup

补充区分

• pg_dumpall：整实例（所有库 + 账号权限）逻辑备份
• pg_dump：单个数据库逻辑备份
• pg_basebackup：物理文件级备份（适合 TB 级大数据）

如果你需要，我可以给你适配 Anolis OS 8 / CentOS7 的 crontab 定时任务完整配置。