PostgreSQL / 系统课时

备份角色与表空间定义

备份角色与表空间定义

只执行数据库级 pg_dump 会漏掉角色、角色成员关系和表空间定义,恢复时常表现为 owner 不存在、授权失败或 tablespace 缺失。本课使用 pg_dumpall --globals-only 补齐这些集群级定义,并把角色冲突和表空间目录条件纳入恢复前检查。

学习目标

  • 区分数据库级对象与 PostgreSQL 集群级全局对象。
  • 使用 pg_dumpall --globals-only 生成并保护全局对象 SQL。
  • 在恢复前处理角色冲突,以及表空间目录的存在性、所有权、权限和空目录要求。

划清数据库对象与全局对象

pg_dump 面向单个数据库,适合备份 schema、表、视图、函数和数据等对象;角色和表空间属于整个 PostgreSQL 集群,不归某一个数据库所有,因此需要额外备份。

范围 典型对象 推荐工具 漏备后的直接影响
数据库级 schema、表、视图、函数、数据 pg_dump 数据库对象或数据缺失
集群级 角色、角色属性、成员关系 pg_dumpall --globals-only owner、GRANT、默认权限引用的角色不存在
集群级 用户表空间定义 pg_dumpall --globals-only 恢复到指定 tablespace 时失败

因此,完整的逻辑备份应把各数据库 dump 与同一集群的 globals 文件作为一组交付物,而不是只保存数据库备份。

导出并保护全局对象

为了完整读取角色属性及认证信息,执行账号通常需要足够高的集群权限;恢复时也需要能够创建或修改角色、创建表空间的管理员账号。下面把全局对象导出为纯 SQL 文件,并限制新建文件的默认权限。

bash
set -euo pipefail

export PGHOST="<HOST>"
export PGPORT="<PORT>"
export PGUSER="<SUPERUSER>"
export PGDATABASE="postgres"
export PGPASSFILE="<PATH>/.pgpass"

GLOBALS_FILE="<PATH>/cluster-globals.sql"
umask 077

pg_dumpall \
  --globals-only \
  --file="$GLOBALS_FILE"

test -s "$GLOBALS_FILE" && echo "globals backup ready"

预期输出

text
globals backup ready

pg_dumpall 生成的是供 psql 执行的纯 SQL,而不是 pg_restore 能读取的 archive。实际 <HOST>、<PORT> 和 <PATH> 会随环境变化。

恢复前检查角色与表空间

恢复到新集群时,应先准备全局对象,再恢复依赖这些对象的数据库,因为数据库对象的 owner、ACL 和 tablespace 引用都要求相应角色或表空间存在。

首先检查目标集群是否已经存在同名角色。pg_dumpall --globals-only 会生成角色创建语句,而新初始化的集群本身至少已经有一个 bootstrap 超级用户;如果源端存在同名角色,直接使用 ON_ERROR_STOP 执行 globals SQL 会在 CREATE ROLE 冲突处停止。应先决定复用现有角色、重新初始化目标集群,或对 globals SQL 做受控调整,再执行恢复。不要为了消除报错而直接删除仍被目标环境使用的角色。

用户表空间还依赖目标服务器文件系统。对于 globals SQL 中每个 CREATE TABLESPACE ... LOCATION,目标 LOCATION 必须在执行语句前已经存在,并由运行 PostgreSQL 服务的操作系统用户正确拥有、具备所需权限,而且目录必须为空。目录中即使只有旧表空间遗留文件,也不满足创建条件;PostgreSQL 会拒绝在非空目录上创建新的表空间。

如果新环境的磁盘布局不同,应先把 globals SQL 中用户表空间的 LOCATION 修改为新主机上的目标路径,再准备对应的空目录。默认表空间 pg_default 和 pg_global 不需要自行创建目录。

执行 globals 并验证

完成角色冲突处理,并确认所有用户表空间目录满足“存在、归属正确、权限正确且为空”后,再执行 globals SQL。下面的恢复命令使用 ON_ERROR_STOP,因此前置冲突必须已经解决。

bash
set -euo pipefail

GLOBALS_FILE="<PATH>/cluster-globals.sql"

psql -X \
  --host="<DEST_HOST>" \
  --port="<PORT>" \
  --username="<SUPERUSER>" \
  --dbname=postgres \
  --set=ON_ERROR_STOP=on \
  --file="$GLOBALS_FILE"

psql -X \
  --host="<DEST_HOST>" \
  --port="<PORT>" \
  --username="<SUPERUSER>" \
  --dbname=postgres \
  --tuples-only \
  --no-align \
  --command="
SELECT 'role=' || rolname
FROM pg_roles
WHERE rolname = '<ROLE>';

SELECT 'tablespace=' || spcname
FROM pg_tablespace
WHERE spcname = '<TABLESPACE>';"

预期结果

text
role=<ROLE>
tablespace=<TABLESPACE>

其中 <ROLE> 和 <TABLESPACE> 要替换为备份中实际存在的角色与用户表空间名称;若没有自定义表空间,可只验证角色。globals 恢复成功后,再执行各数据库的 pg_restore 或 psql 恢复流程。

验收恢复后的权限与存储位置

如果数据库恢复使用了 --no-owner 或 --no-acl,即使 globals 已恢复,也会主动跳过原始 owner 或权限信息。这可以作为迁移策略,但必须由后续流程重新建立所有权和授权,不能误判为 globals 没有生效。

每个备份周期都应同时保存数据库 dump、globals SQL、生成时间和来源集群标识,并在恢复演练中检查关键角色及成员关系、用户表空间映射与目录条件,以及数据库对象的 owner 和 GRANT 是否符合预期。

globals 文件通常很小,却决定逻辑恢复后的权限和存储位置是否完整。坚持“处理角色冲突并准备空且归属正确的表空间目录 → 恢复 globals → 恢复数据库”的顺序,可以避免数据已经恢复却因权限或表空间缺口无法正常接管业务。

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

目录与阅读设置

阅读设置

17

记录一个想法

备份角色与表空间定义

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

登录哪都通