如何安全编辑pg_dump生成的toc.dat文件重命名PostgreSQL schema

问题根源 #

直接用sed/perl修改toc.dat会触发段错误，因为toc.dat是二进制格式的控制文件，并非纯文本。盲目替换字符串会破坏文件内部的二进制结构（比如带长度标记的字符串字段），导致pg_restore解析时内存越界。

推荐解决方案 #

方案1：直接用pg_restore的映射参数（无需修改备份） #

这是最安全高效的方式，不需要编辑任何备份文件，直接在恢复时指定Schema映射：

pg_restore --no-owner --no-acl -h localhost -p 5433 -U username -d other_dbname --schema=schema:schema_new -v directory

--schema=原Schema:新Schema参数会自动将备份中所有属于schema的对象重定向到schema_new，完全满足你的需求。

方案2：通过文本TOC引导恢复（需修改备份元数据） #

如果必须修改备份本身，不要直接编辑二进制toc.dat，而是导出文本格式的TOC修改后再引导恢复：

1. 从目录备份导出纯文本TOC：

pg_restore --list directory > toc.txt

2. 编辑toc.txt，将所有涉及schema的条目替换为schema_new（注意保留引号，比如把"schema".table改成"schema_new".table，避免误替换）
3. 使用修改后的TOC执行恢复：

pg_restore --no-owner --no-acl -h localhost -p 5433 -U username -d other_dbname --use-list=toc.txt -v directory

这种方式不会破坏备份的二进制数据，只是用自定义的文本TOC来指导恢复流程。

关键提示 #

• 目录格式备份（-Fd）的toc.dat是二进制结构，包含对象ID、依赖关系等带格式的元数据，绝对不能直接用文本替换工具修改。
• 你使用的pg_dump/pg_restore版本（15.6）高于目标数据库版本（14.10），虽然跨版本兼容，但尽量保持工具与数据库版本一致能避免潜在问题。

内容的提问来源于stack exchange，提问作者jlnvn