PostgreSQL / 系统课时

处理物理备份中的表空间

处理物理备份中的表空间

外部表空间把部分数据库文件放在 PGDATA 之外,物理备份若只盯着主数据目录,就容易在恢复时得到断裂路径。本节先识别表空间位置,再规划备份与目标机目录映射。

学习目标

  • 找出数据库中的外部表空间及其实际路径
  • 理解 PGDATA/pg_tblspc、表空间 OID 与外部目录的关系
  • 在备份和恢复前规划可验证的目标路径映射

先列出所有表空间位置

pg_default 与 pg_global 属于集群内部布局,真正需要额外规划的是用户创建的外部表空间。先从数据库目录中读取实际位置,而不要靠运维文档里的旧路径猜测:

sql
SELECT
  oid,
  spcname,
  COALESCE(NULLIF(pg_tablespace_location(oid), ''), '<inside PGDATA>') AS location
FROM pg_tablespace
ORDER BY oid;

预期结果

text
 oid  |  spcname   |              location
------+------------+-------------------------------------
 <ID> | pg_default | <inside PGDATA>
 <ID> | pg_global  | <inside PGDATA>
 <ID> | fast_ts    | /srv/postgresql/tblspc/fast

<ID> 会随集群不同而变化。恢复时要保留的是“表空间 OID 对应哪份物理内容、最终应该落到哪个目录”这组关系,而不是照抄示例中的数字。

看懂 pg_tblspc 与外部目录的关系

对外部表空间,$PGDATA/pg_tblspc/<OID> 是指向实际表空间目录的符号链接。表、索引等对象的数据文件位于链接目标下,并继续按 PostgreSQL 版本和数据库 OID 组织子目录。

PGDATA、pg_tblspc 与外部表空间目录的映射关系

可在操作系统上再次核对链接目标:

bash
find "$PGDATA/pg_tblspc" -mindepth 1 -maxdepth 1 -type l \
  -printf '%f -> %l\n'

预期输出

text
<ID> -> /srv/postgresql/tblspc/fast

如果 SQL 查询与符号链接指向不一致,应先确认当前实例与数据目录是否匹配,而不是继续复制文件。

在备份阶段显式规划映射

使用 pg_basebackup 的 plain 格式时,可以用 -T olddir=newdir 把服务器上的表空间路径映射到备份机上的绝对路径。olddir 必须与源集群报告的表空间位置精确匹配,newdir 则属于运行 pg_basebackup 的接收端文件系统;若目标目录已经存在,它必须为空。

bash
SOURCE_TS=/srv/postgresql/tblspc/fast
BACKUP_TS=/backup/tablespaces/fast

install -d -m 700 "$BACKUP_TS"

pg_basebackup \
  -h <PRIMARY_HOST> \
  -p <PORT> \
  -U backup_user \
  -D /backup/base/current \
  -Fp -Xs \
  -T "$SOURCE_TS=$BACKUP_TS" &&
printf 'base backup completed\n'

预期输出

text
base backup completed

执行前还应确保 /backup/base/current 不存在或为空。<PRIMARY_HOST> 与 <PORT> 需要替换为实际连接信息。此映射解决的是“备份机怎样落盘”,不会自动保证未来恢复主机也存在同一路径,所以恢复设计仍要单独记录目标路径。

在恢复机上重建正确目录关系

恢复前先为每个外部表空间确定目标目录,检查容量、挂载点、所有者和权限,再把对应表空间的数据放入该目录。PostgreSQL 停止状态下,$PGDATA/pg_tblspc/<OID> 最终必须指向这个目标位置。

完成数据放置与链接调整后,用 readlink 做最小验证:

bash
TS_OID=<ID>
TARGET_TS=/srv/postgresql/tblspc/fast-restored

readlink "$PGDATA/pg_tblspc/$TS_OID"
test "$(readlink "$PGDATA/pg_tblspc/$TS_OID")" = "$TARGET_TS" &&
  echo "tablespace mapping verified"

预期输出

text
/srv/postgresql/tblspc/fast-restored
tablespace mapping verified

这里的 <ID> 必须来自当前备份对应的表空间 OID,不能随意新建一个编号。若目标机没有源路径对应的磁盘,也不必强行复制源目录结构;关键是把该 OID 的表空间内容完整恢复到已规划的新目录,并让 pg_tblspc 链接指向它。

避免最常见的恢复失败

只复制 PGDATA 而遗漏外部表空间,会留下指向不存在目录的链接;只创建空目录而没有恢复表空间文件,则可能在启动或访问对象时暴露缺失。另一个常见问题是目标目录存在但属于错误用户,导致 PostgreSQL 无法进入目录或读写数据。

因此,物理备份资产清单应同时保存三类信息:表空间名称与 OID、源路径、计划恢复路径。恢复验收也要同时检查主数据目录和每个外部表空间,而不是把 PGDATA 能启动当作全部成功标准。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理物理备份中的表空间

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通