PostgreSQL / 系统课时
使用 pg_restore 选择性恢复
使用 pg_restore 选择性恢复
pg_restore 可从归档中精确选择对象,并在依赖、所有者与权限可控的前提下恢复到目标库。本文用 custom-format 归档演示按 schema、table、section 与 TOC 清单恢复,形成可验证的对象级恢复流程。
学习目标
- 会用
--schema、--table和--section缩小恢复范围。 - 会用
pg_restore -l与-L控制对象清单和恢复顺序。 - 能处理 owner、privilege 与对象依赖导致的常见恢复失败。
先确认归档与目标库
pg_restore 只处理 pg_dump 生成的 custom、directory 或 tar 归档;plain SQL 应交给 psql。恢复前先读取归档目录,不修改数据库,就能确认对象名、schema 和归档是否可识别。
ARCHIVE='<PATH>/app.dump'
pg_restore --list "$ARCHIVE" | head -n 12预期输出
; Archive created at <TIME>
; dbname: <DBNAME>
; TOC Entries: <VALUE>
<ID>; <OID> <OID> SCHEMA - app app_owner
<ID>; <OID> <OID> TABLE app orders app_owner
<ID>; <OID> <OID> TABLE DATA app orders app_owner实际 TOC 编号、OID、时间和数据库名会不同。若这里就报“input file does not appear to be a valid archive”,应先确认文件类型,而不是继续尝试恢复参数。
按 schema、table 与 section 选择范围
--schema=app 只筛选 schema 内部对象,并不适合假设它会替你准备一个全新的目标 schema。更稳妥的做法是先创建空数据库和目标 schema,再执行范围恢复;这样 schema 自身的 owner 与 ACL 也由目标环境明确控制。
ARCHIVE='<PATH>/app.dump'
createdb --template=template0 restore_lab
psql -d restore_lab -v ON_ERROR_STOP=1 -c 'CREATE SCHEMA app;'
pg_restore --dbname=restore_lab \
--schema=app \
--no-owner \
--no-privileges \
--exit-on-error \
"$ARCHIVE"预期结果
CREATE SCHEMA
pg_restore 成功时通常不输出正文;全部命令退出码为 0。只筛选单表时,pg_restore 的 --table 参数写表名本身,schema 用 --schema 另行限定;不要写成 --table=app.orders。而且 --table 不会自动把所选表依赖的其他对象或所有附属对象一起纳入恢复,因此恢复前应先检查 TOC。
ARCHIVE='<PATH>/app.dump'
pg_restore --list --schema=app --table=orders "$ARCHIVE"预期输出
; Selected TOC Entries:
<ID>; <OID> <OID> TABLE app orders app_owner
<ID>; <OID> <OID> TABLE DATA app orders app_owner实际列表可能还包含与该关系直接匹配的条目,但不要据此假设索引、约束、自定义类型、序列或函数依赖都会自动补齐。若要完整掌控这些对象,后面的 TOC 清单方式更可靠。
当需要显式控制结构、数据和索引约束阶段时,按 pre-data、data、post-data 顺序执行。pre-data 主要处理表、类型等定义,data 装载数据,post-data 再创建索引、触发器和多数约束。
ARCHIVE='<PATH>/app.dump'
createdb --template=template0 restore_sections
psql -d restore_sections -v ON_ERROR_STOP=1 -c 'CREATE SCHEMA app;'
pg_restore -d restore_sections -n app --section=pre-data --no-owner --no-privileges --exit-on-error "$ARCHIVE"
pg_restore -d restore_sections -n app --section=data --no-owner --no-privileges --exit-on-error "$ARCHIVE"
pg_restore -d restore_sections -n app --section=post-data --no-owner --no-privileges --exit-on-error "$ARCHIVE"预期结果
CREATE SCHEMA
三次 pg_restore 均退出码为 0;目标库先出现对象定义,再写入数据,最后补齐索引、触发器与约束。不要把 post-data 提前到数据装载之前。这样不仅可能触发依赖错误,还会让大量索引维护拖慢数据恢复。
用 TOC 清单精确控制对象
复杂恢复通常先导出 TOC,再复制一份作为恢复清单。清单中的每一行对应一个归档对象;以分号开头的条目会被跳过,未出现在清单中的对象也不会恢复。-L 会按清单中的顺序处理条目,因此它同时承担“选什么”和“按什么顺序恢复”两件事。
ARCHIVE='<PATH>/app.dump'
LIST_FILE='<PATH>/app.list'
ORDERS_LIST='<PATH>/orders.list'
pg_restore --list "$ARCHIVE" > "$LIST_FILE"
cp "$LIST_FILE" "$ORDERS_LIST"预期结果
命令退出码为 0;<PATH>/app.list 与 <PATH>/orders.list 均包含归档 TOC。下面是 orders.list 的片段示例。实际使用时应从 pg_restore --list 的真实结果复制并编辑,不能手写 TOC 编号或 OID。
<ID>; <OID> <OID> SCHEMA - app app_owner
<ID>; <OID> <OID> TABLE app orders app_owner
<ID>; <OID> <OID> TABLE DATA app orders app_owner
<ID>; <OID> <OID> CONSTRAINT app orders orders_pkey app_owner
;<ID>; <OID> <OID> TABLE app audit_log app_owner编辑后用 -L 执行清单。若清单保留了 SCHEMA app 条目,就让归档创建 schema;如果你删除了该条目,则必须提前准备目标 schema。
ARCHIVE='<PATH>/app.dump'
ORDERS_LIST='<PATH>/orders.list'
createdb --template=template0 restore_orders
pg_restore --dbname=restore_orders \
--use-list="$ORDERS_LIST" \
--no-owner \
--no-privileges \
--exit-on-error \
"$ARCHIVE"预期结果
命令退出码为 0;只处理 <PATH>/orders.list 中未被注释的归档条目。-L 不是依赖求解器。若清单遗漏自定义类型、序列、扩展或被约束引用的表,恢复仍可能失败;应根据首个错误回到 TOC 补齐前置对象,而不是简单忽略错误继续执行。
处理 owner、privilege 与角色差异
是否保留源库角色语义,应在恢复前明确决定。迁移到同构生产环境时,可以保留归档中的 owner 与 ACL,但目标集群必须预先存在对应角色,并且执行恢复的账号有足够权限。恢复到开发、测试或租户隔离环境时,通常更适合使用 --no-owner --no-privileges,让对象归当前恢复账号所有,再由环境自己的权限脚本统一授权。
--role=<ROLE> 只是在连接后以指定的现有角色执行恢复动作;它不会把归档里记录的旧 owner 自动改名。遇到 role "<ROLE>" does not exist 时,应选择创建该角色、关闭 owner 恢复,或重新设计目标角色映射,而不是把错误当成普通警告。
验证对象与数据都已恢复
恢复命令成功只说明归档动作没有报错,仍应检查关键对象是否存在并核对数据量。下面以 app.orders 为验收对象。
psql -d restore_lab -v ON_ERROR_STOP=1 \
-c "SELECT to_regclass('app.orders') AS restored_table;" \
-c "SELECT count(*) AS rows FROM app.orders;"预期输出
restored_table
----------------
app.orders
rows
-------
<VALUE><VALUE> 应与备份时的业务口径或校验记录一致。选择性恢复的核心不是“少恢复一些”,而是把选择范围、依赖闭包和目标权限模型一起设计;只要这三件事对齐,pg_restore 就能稳定承担表级、schema 级和对象清单级恢复。