PostgreSQL / 系统课时
处理物理备份中的表空间
处理物理备份中的表空间
外部表空间把部分数据库文件放在 PGDATA 之外,物理备份若只盯着主数据目录,就容易在恢复时得到断裂路径。本节先识别表空间位置,再规划备份与目标机目录映射。
学习目标
- 找出数据库中的外部表空间及其实际路径
- 理解
PGDATA/pg_tblspc、表空间 OID 与外部目录的关系 - 在备份和恢复前规划可验证的目标路径映射
先列出所有表空间位置
pg_default 与 pg_global 属于集群内部布局,真正需要额外规划的是用户创建的外部表空间。先从数据库目录中读取实际位置,而不要靠运维文档里的旧路径猜测:
SELECT
oid,
spcname,
COALESCE(NULLIF(pg_tablespace_location(oid), ''), '<inside PGDATA>') AS location
FROM pg_tablespace
ORDER BY oid;预期结果
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 组织子目录。

可在操作系统上再次核对链接目标:
find "$PGDATA/pg_tblspc" -mindepth 1 -maxdepth 1 -type l \
-printf '%f -> %l\n'预期输出
<ID> -> /srv/postgresql/tblspc/fast如果 SQL 查询与符号链接指向不一致,应先确认当前实例与数据目录是否匹配,而不是继续复制文件。
在备份阶段显式规划映射
使用 pg_basebackup 的 plain 格式时,可以用 -T olddir=newdir 把服务器上的表空间路径映射到备份机上的绝对路径。olddir 必须与源集群报告的表空间位置精确匹配,newdir 则属于运行 pg_basebackup 的接收端文件系统;若目标目录已经存在,它必须为空。
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'预期输出
base backup completed执行前还应确保 /backup/base/current 不存在或为空。<PRIMARY_HOST> 与 <PORT> 需要替换为实际连接信息。此映射解决的是“备份机怎样落盘”,不会自动保证未来恢复主机也存在同一路径,所以恢复设计仍要单独记录目标路径。
在恢复机上重建正确目录关系
恢复前先为每个外部表空间确定目标目录,检查容量、挂载点、所有者和权限,再把对应表空间的数据放入该目录。PostgreSQL 停止状态下,$PGDATA/pg_tblspc/<OID> 最终必须指向这个目标位置。
完成数据放置与链接调整后,用 readlink 做最小验证:
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"预期输出
/srv/postgresql/tblspc/fast-restored
tablespace mapping verified这里的 <ID> 必须来自当前备份对应的表空间 OID,不能随意新建一个编号。若目标机没有源路径对应的磁盘,也不必强行复制源目录结构;关键是把该 OID 的表空间内容完整恢复到已规划的新目录,并让 pg_tblspc 链接指向它。
避免最常见的恢复失败
只复制 PGDATA 而遗漏外部表空间,会留下指向不存在目录的链接;只创建空目录而没有恢复表空间文件,则可能在启动或访问对象时暴露缺失。另一个常见问题是目标目录存在但属于错误用户,导致 PostgreSQL 无法进入目录或读写数据。
因此,物理备份资产清单应同时保存三类信息:表空间名称与 OID、源路径、计划恢复路径。恢复验收也要同时检查主数据目录和每个外部表空间,而不是把 PGDATA 能启动当作全部成功标准。