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 适用）
| 参数 | 说明 |
|---|---|
-U user | 指定数据库用户（必须超级用户） |
-h host | 数据库地址 |
-p port | 端口 |
-w | 不提示密码（配合 .pgpass） |
-W | 强制弹出密码输入 |
-g / --globals-only | 只备份全局对象（角色、表空间，不含数据库数据） |
-r / --roles-only | 仅备份角色 |
-t / --tablespaces-only | 仅备份表空间 |
-c / --clean | 备份中增加 DROP 语句，恢复前先删除对象 |
-s / --schema-only | 只导出结构，不导出数据 |
-f file | 指定输出文件（替代重定向 >） |
示例带清理语句：
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重要提醒：
- 恢复目标 PG 版本 ≥ 备份版本；PG14 的 dumpall 可以恢复到 14/15/16，不建议往更低版本恢复
- 如果跨机器迁移：目标库不存在同名角色会报错，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
- pg_dumpall 不支持自定义格式（只能纯 sql 文本）如果你想要并行、压缩自定义格式，只能单库使用
pg_dump -Fd；整实例只能 sql 脚本。 - 大实例：
pg_dumpall单进程，速度不如分库并行 pg_dump - 备份期间会获取共享快照，长时间备份存在长事务风险
- 逻辑备份≠物理备份，超大库优先考虑
pg_basebackup
补充区分
- pg_dumpall：整实例（所有库 + 账号权限）逻辑备份
- pg_dump：单个数据库逻辑备份
- pg_basebackup：物理文件级备份（适合 TB 级大数据）
如果你需要，我可以给你适配 Anolis OS 8 / CentOS7 的 crontab 定时任务完整配置。