PostgreSQL 14 pg_dumpall 完整备份指南

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

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

一、基础语法

bash 复制代码

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

最简本地备份

bash 复制代码

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

远程实例备份

bash 复制代码

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`	指定输出文件（替代重定向 >）

示例带清理语句：

bash 复制代码

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

五、恢复命令

整实例恢复（覆盖导入）

bash 复制代码

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 定时任务完整配置。