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 文件,并限制新建文件的默认权限。
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"预期输出
globals backup readypg_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,因此前置冲突必须已经解决。
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>';"预期结果
role=<ROLE>
tablespace=<TABLESPACE>其中 <ROLE> 和 <TABLESPACE> 要替换为备份中实际存在的角色与用户表空间名称;若没有自定义表空间,可只验证角色。globals 恢复成功后,再执行各数据库的 pg_restore 或 psql 恢复流程。
验收恢复后的权限与存储位置
如果数据库恢复使用了 --no-owner 或 --no-acl,即使 globals 已恢复,也会主动跳过原始 owner 或权限信息。这可以作为迁移策略,但必须由后续流程重新建立所有权和授权,不能误判为 globals 没有生效。
每个备份周期都应同时保存数据库 dump、globals SQL、生成时间和来源集群标识,并在恢复演练中检查关键角色及成员关系、用户表空间映射与目录条件,以及数据库对象的 owner 和 GRANT 是否符合预期。
globals 文件通常很小,却决定逻辑恢复后的权限和存储位置是否完整。坚持“处理角色冲突并准备空且归属正确的表空间目录 → 恢复 globals → 恢复数据库”的顺序,可以避免数据已经恢复却因权限或表空间缺口无法正常接管业务。