PostgreSQL基础备份怎么做?如何确认备份文件可以用于恢复?

发布人:A5数据发布时间:2026-10-24 09:53阅读量:71

PostgreSQL基础备份的首次实施目标,不只是生成一个目录,而是拿到一份包含数据库文件和恢复所需WAL、经过校验,并且能在隔离环境中启动的备份。下面以Ubuntu 24.04上的PostgreSQL 16为例,使用pg_basebackup制作物理基础备份,再用pg_verifybackup检查文件,最后完成一次恢复演练。

这一方案适合整套PostgreSQL实例的备份与恢复,不适合只导出某一张表。它可以恢复到该份备份所覆盖的一致状态;仅有基础备份,不能任选一个历史时间点恢复。如果业务要求按时间点恢复,还需要另外规划连续WAL归档,并把归档链纳入演练。

引言配图

准备条件:先确认备份范围与恢复目标

本次从运行中的主库执行备份。操作人员需要有服务器管理权限,目标磁盘应与数据库数据目录分开,并预留备份文件、传输副本和演练所需空间。示例命令使用本机postgres系统用户连接数据库,不创建额外的复制账号;若实际环境使用远程备份机,应单独配置复制权限、认证和传输保护,不要直接照搬本机连接方式。

先核对实例版本、数据目录和主从状态:

sudo -u postgres psql -Atqc "SELECT version();"
sudo -u postgres psql -Atqc "SHOW data_directory;"
sudo -u postgres psql -Atqc "SELECT pg_is_in_recovery();"

第三条在本例中应返回f,表示连接的是主库。再确认备份工具版本与服务器大版本一致,并检查是否存在用户创建的外部表空间:

/usr/lib/postgresql/16/bin/pg_basebackup --version
/usr/lib/postgresql/16/bin/pg_verifybackup --version

sudo -u postgres psql -P pager=off -c \
"SELECT spcname, pg_tablespace_location(oid) AS location
 FROM pg_tablespace
 WHERE pg_tablespace_location(oid) <> '';"

本文后续的目录复制演练以查询结果为零行为前提。若返回了外部表空间,基础备份还涉及这些表空间的实际存放路径;应先设计备份目标与恢复端的表空间路径映射,不能在已有同名路径的生产服务器上直接演练,以免覆盖生产文件。

还要确认备份目录不在数据库数据目录内,且磁盘空间充足:

df -h /srv
sudo -u postgres psql -Atqc "SHOW max_wal_senders;"

-X stream会在基础备份期间同时获取WAL,至少需要可用的WAL发送进程连接。若当前连接已占满上限,应先评估实例配置和现有复制连接,而不是在备份失败后反复重试。

创建第一份基础备份

以下命令在同一个终端会话中依次执行,BACKUP_DIR变量会供后面的检查命令使用。备份根目录由管理员创建,仅允许postgres用户访问;不要把目标设为正在使用的数据目录或已有业务文件的目录。

sudo install -d -m 0700 -o postgres -g postgres /srv/pgbackups

BACKUP_DIR="/srv/pgbackups/base_$(date -u +%Y%m%dT%H%M%SZ)"
export BACKUP_DIR

sudo -u postgres /usr/lib/postgresql/16/bin/pg_basebackup \
  -h /var/run/postgresql \
  -U postgres \
  -D "$BACKUP_DIR" \
  -F plain \
  -X stream \
  -P

-F plain生成可直接作为数据目录使用的文件布局,便于首次恢复演练;-X stream将备份达到一致状态所需的WAL一并取得。命令运行期间数据库可以继续提供服务,但备份会产生磁盘读取、WAL传输和目标盘写入负载,首次执行宜安排在能够观察实例负载的时段。

命令以退出码0结束,只说明备份程序完成了工作,还不能代替文件校验或启动测试。先检查目录、关键文件及占用空间:

printf 'backup directory: %s\n' "$BACKUP_DIR"
sudo -u postgres test -f "$BACKUP_DIR/backup_manifest" && echo "manifest exists"
sudo -u postgres test -f "$BACKUP_DIR/backup_label" && echo "backup label exists"
sudo -u postgres test -d "$BACKUP_DIR/pg_wal" && echo "pg_wal exists"
sudo du -sh "$BACKUP_DIR"

预期三个检查均输出exists。这些文件或目录缺失时,不要把这份备份登记为可用备份。尤其不要为了让检查通过而手工补建空的pg_wal目录。

校验文件,再验证它能否恢复

PostgreSQL 16的pg_basebackup会生成备份清单。使用相同大版本的pg_verifybackup,检查清单、文件内容及所需WAL:

sudo -u postgres /usr/lib/postgresql/16/bin/pg_verifybackup "$BACKUP_DIR"
echo "verify exit code: $?"

退出码为0,并出现类似backup successfully verified的结果,表示这份备份通过了该工具的检查。示例文字用于说明应观察什么,不代表对某台服务器的实际执行记录。若命令报文件缺失、校验不符或WAL检查失败,应将该备份标记为不可用,保留错误输出供排查,并重新生成备份;不要修改清单来掩盖错误。

文件校验仍不能证明数据库在目标机器上一定能启动。例如,目标机器的软件大版本不匹配、外部表空间路径缺失,或恢复配置错误,都可能导致启动失败。因此,首次备份完成后应在隔离测试机或隔离虚拟机上做一次恢复演练。测试机安装相同PostgreSQL大版本,备份目录已完整传入;以下命令只在测试机执行,不在生产实例上执行。

先确认测试机目标目录不存在,避免复制覆盖已有文件。假设传入的备份仍位于变量BACKUP_DIR所指位置:

BACKUP_DIR="/srv/pgbackups/填入实际备份目录名"
RESTORE_DIR="/srv/pg-restore/base-test"
export BACKUP_DIR RESTORE_DIR

test -d "$BACKUP_DIR" || { echo "backup directory not found"; exit 1; }
test ! -e "$RESTORE_DIR" || { echo "restore directory already exists"; exit 1; }

sudo install -d -m 0700 -o postgres -g postgres "$RESTORE_DIR"
sudo -u postgres cp -a "$BACKUP_DIR"/. "$RESTORE_DIR"/
sudo -u postgres /usr/lib/postgresql/16/bin/pg_verifybackup "$RESTORE_DIR"

这里的复制会占用另一份备份大小的磁盘空间,不会修改原备份。复制后再次校验,能够同时发现传输或落盘过程中造成的文件问题。若测试机上也存在生产业务实例,应进一步隔离网络、端口和存储路径;不要仅凭“端口不同”就认为误操作风险已经消除。

Ubuntu发行版安装的PostgreSQL实例可能将主配置文件放在数据目录之外。测试目录启动前,为演练实例写入独立配置,并检查备份中是否有会改变启动行为的自动配置或恢复信号文件:

sudo -u postgres sh -c \
  'cat "$1/postgresql.auto.conf" 2>/dev/null || true' sh "$RESTORE_DIR"

sudo -u postgres ls -l \
  "$RESTORE_DIR/recovery.signal" \
  "$RESTORE_DIR/standby.signal" 2>/dev/null || true

如果postgresql.auto.conf中存在data_directory、归档或复制相关设置,或出现预期之外的信号文件,应先弄清其来源和作用,暂缓启动;不能直接删除生产备份里的文件。下面的启动示例仅适用于前述检查没有发现冲突,且没有外部表空间的演练环境:

sudo -u postgres tee "$RESTORE_DIR/postgresql.conf" >/dev/null <<'EOF'
listen_addresses = ''
port = 55432
unix_socket_directories = '/var/run/postgresql'
hba_file = 'pg_hba.conf'
archive_mode = off
EOF

sudo -u postgres tee "$RESTORE_DIR/pg_hba.conf" >/dev/null <<'EOF'
local all all peer
EOF

sudo -u postgres /usr/lib/postgresql/16/bin/pg_ctl \
  -D "$RESTORE_DIR" \
  -l "$RESTORE_DIR/rehearsal.log" \
  -o "-c config_file=$RESTORE_DIR/postgresql.conf" \
  start

该配置只监听本机Unix套接字,使用55432端口,不开放网络连接,也不运行归档命令。它的作用是验证备份启动,不应当作为生产实例配置。若启动失败,先查看测试目录中的rehearsal.log:缺少WAL、版本不匹配、路径权限错误和配置冲突应分别处理;不要转而对生产数据目录执行修复命令。

实例启动后,检查连接对象、恢复状态和业务数据。业务检查应事先选好一张可读、不会触发写入的关键表或一组只读查询:

sudo -u postgres psql \
  -h /var/run/postgresql -p 55432 -U postgres \
  -Atqc "SHOW data_directory;"

sudo -u postgres psql \
  -h /var/run/postgresql -p 55432 -U postgres \
  -Atqc "SELECT pg_is_in_recovery();"

第一条应返回测试目录路径,而不是生产数据目录。基础备份完成恢复并作为独立主库启动后,第二条通常返回f。随后核对预期数据库、表和关键数据的只读查询结果;能连接但缺少所需业务对象,不能算演练通过。

校验文件,再验证它能否恢复配图

首次运行后的频率、保留与异常处理

备份频率要从可接受的数据损失倒推。如果业务最多只能接受约一天的数据回退,可考虑每日生成一份基础备份;这不等于承诺任意故障都能恢复到故障前一刻。需要更小恢复点目标时,应设计连续WAL归档,并验证基础备份与归档WAL能够组成完整恢复链。

保留周期同时受恢复需求和空间限制影响。例如,计划保留最近7份每日备份及4份每周留存备份时,应明确每周留存是否从每日备份中选取,避免重复计算或误删。容量预算不能只看数据库当前占用:还要计算备份期间增长、WAL、异地副本及至少一次演练复制所需空间。基础备份建议至少留有独立副本,防止数据库主机故障同时损坏本机备份盘。

将来自动化运行时,应把以下异常视为备份失败,而不是只记录“任务已触发”:

  • pg_basebackup非零退出、目标空间不足或复制连接失败:检查磁盘、权限、认证与WAL发送连接;保留日志,修复后生成新备份。
  • pg_verifybackup失败:隔离该份备份,不纳入可恢复清单;检查存储和传输链路,并重新备份。
  • 演练无法启动或关键只读查询不符:记录错误、实际恢复耗时和影响范围,修正方案后重新演练;不要用文件校验通过替代恢复验收。

自动清理旧备份前,必须确认新备份已完成校验,且保留窗口内仍有可用的恢复副本。本文不提供批量删除命令:清理会永久影响可恢复时间范围,应先列出待删目录、核对保留策略和异地副本,再执行受控删除。

围绕 PostgreSQL 基础备份的留存与恢复演练,A5数据提供香港、美国、日本等地区的物理服务器资源。配备 NVMe 的服务器可承载数据库业务或独立演练环境;香港存储系列和日本部分大容量 HDD 方案可为备份文件、历史副本及归档数据提供存放空间。不同地区的线路与带宽选择,也为跨地区部署和备份副本传输提供网络资源基础。

验收与回滚检查项

首次部署的验收记录应能回答“备了什么、何时备的、检验了什么、恢复到了哪里”:

  • 备份范围:记录服务器大版本、数据目录、数据库实例和外部表空间检查结果;本例要求无外部表空间。
  • 文件与一致性:记录备份命令退出码、目录大小、pg_verifybackup结果,以及备份目录和WAL文件是否完整。
  • 恢复结果:记录测试机软件版本、启动日志、实际数据目录、关键只读查询结果及从开始复制到可用的耗时。
  • 持续运行:确定备份频率、保留周期、容量告警、异地副本位置和下一次恢复演练时间。

若恢复演练不通过,回滚范围仅限隔离测试实例:先停止它,再核对目录路径后处理测试副本;原始备份及生产实例保持不动。

sudo -u postgres /usr/lib/postgresql/16/bin/pg_ctl \
  -D "$RESTORE_DIR" -m fast stop

停止后确认55432端口已无该演练实例、生产实例仍可正常连接。不要把未通过演练的备份作为唯一留存副本,也不要为了“回滚”而覆盖生产数据目录。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5408.html

相关推荐