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 和归档是否可识别。

bash
ARCHIVE='<PATH>/app.dump'
pg_restore --list "$ARCHIVE" | head -n 12

预期输出

text
; 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 也由目标环境明确控制。

bash
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"

预期结果

text
CREATE SCHEMA
pg_restore 成功时通常不输出正文;全部命令退出码为 0。

只筛选单表时,pg_restore 的 --table 参数写表名本身,schema 用 --schema 另行限定;不要写成 --table=app.orders。而且 --table 不会自动把所选表依赖的其他对象或所有附属对象一起纳入恢复,因此恢复前应先检查 TOC。

bash
ARCHIVE='<PATH>/app.dump'
pg_restore --list --schema=app --table=orders "$ARCHIVE"

预期输出

text
; 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 再创建索引、触发器和多数约束。

bash
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"

预期结果

text
CREATE SCHEMA
三次 pg_restore 均退出码为 0;目标库先出现对象定义,再写入数据,最后补齐索引、触发器与约束。

不要把 post-data 提前到数据装载之前。这样不仅可能触发依赖错误,还会让大量索引维护拖慢数据恢复。

用 TOC 清单精确控制对象

复杂恢复通常先导出 TOC,再复制一份作为恢复清单。清单中的每一行对应一个归档对象;以分号开头的条目会被跳过,未出现在清单中的对象也不会恢复。-L 会按清单中的顺序处理条目,因此它同时承担“选什么”和“按什么顺序恢复”两件事。

bash
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"

预期结果

text
命令退出码为 0;<PATH>/app.list 与 <PATH>/orders.list 均包含归档 TOC。

下面是 orders.list 的片段示例。实际使用时应从 pg_restore --list 的真实结果复制并编辑,不能手写 TOC 编号或 OID。

text
<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。

bash
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"

预期结果

text
命令退出码为 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 为验收对象。

bash
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;"

预期输出

text
 restored_table
----------------
 app.orders

 rows
-------
 <VALUE>

<VALUE> 应与备份时的业务口径或校验记录一致。选择性恢复的核心不是“少恢复一些”,而是把选择范围、依赖闭包和目标权限模型一起设计;只要这三件事对齐,pg_restore 就能稳定承担表级、schema 级和对象清单级恢复。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 pg_restore 选择性恢复

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

登录哪都通