PostgreSQL的备份恢复体系里，pg_dump配合pg_restore是最常见的组合。但实际运维中很少遇到需要整库恢复的场景，更多情况是某张表被误删、误清空数据，只需要把这一张表从备份文件里捞回来。这时候如果傻乎乎地做整库恢复，不仅耗时，还可能把其他正常的表覆盖掉。pg_restore天生就支持单表恢复，核心就是-t参数。下面把完整语法、各种用法和容易踩的坑一次性讲清楚。
pg_restore恢复单表的基本语法
首先要明确一点：pg_restore只能作用于自定义格式的备份文件，也就是用pg_dump -Fc或-F custom生成的.dump文件，或者目录格式的-Fd备份。如果手里的是纯SQL文本文件（-Fp生成的），那只能用psql去执行，没法用pg_restore选择性恢复。
单表恢复最基础的语法如下：
# 将备份文件中的employees表恢复到目标数据库 pg_restore -d mydb -t employees /path/to/backup.dump # -t 参数的完整写法，效果等同 pg_restore --dbname=mydb --table=employees /path/to/backup.dump
这里的-t后面跟的是表名，不需要带模式名前缀时默认是public模式。如果表在其他schema下，写法是-t myschema.employees。另外-t可以多次出现，一次恢复多张表，比如-t employees -t departments，这在需要恢复有关联关系的表时很实用。
执行前建议先加-l参数列出备份文件的内容，确认表在备份里的准确名字。PostgreSQL的表名如果包含大写字母或特殊字符，在备份目录里是带双引号存储的，-t参数必须一字不差地匹配：
# 列出备份文件中所有对象，grep过滤出表 pg_restore -l /path/to/backup.dump | grep TABLE # 输出类似： # 253; 1259 16456 TABLE public employees postgres # 254; 1259 16462 TABLE public "OrderDetails" postgres
上面例子里的OrderDetails带引号，恢复时就要写-t OrderDetails并在shell里注意引号转义，写成-t 'OrderDetails'或者用-t "OrderDetails"。
恢复表结构和恢复数据的两种模式
pg_restore的-t参数默认会把该表的建表语句和数据一起恢复，但有些场景需要拆开处理。比如误删了数据但表结构还在，直接恢复会报"relation already exists"错误，这时需要加--data-only只灌数据：
# 表已存在，只恢复数据 pg_restore -d mydb -t employees --data-only /path/to/backup.dump # 表被误删，需要连结构一起恢复 pg_restore -d mydb -t employees --clean --if-exists /path/to/backup.dump
--clean的作用是先执行DROP再重建，加上--if-exists可以避免表不存在时DROP语句报错中断。这个组合在做表覆盖恢复时非常常用，但要提醒一句：执行前务必确认目标表里的数据可以丢弃，--clean是不可逆操作。
还有一种情况是只想拿到建表语句看看结构，不想直接动数据库，可以把输出写到文件里：
# 只导出employees表的DDL到sql文件 pg_restore -t employees --schema-only -f employees_ddl.sql /path/to/backup.dump # 只导出数据部分的SQL pg_restore -t employees --data-only -f employees_data.sql /path/to/backup.dump
注意用了-f输出到文件时就不要加-d了，两者是互斥的目标，一个是恢复到库，一个是输出到文件。输出到文件的好处是可以先人工审查SQL内容，确认没问题再通过psql执行，这在生产环境操作时是更稳妥的流程。
单表恢复的常见报错与注意事项
第一个高频问题是恢复时报表已存在。原因上面提过，解决方案有三种：加--data-only只恢复数据；加--clean --if-exists先删后建；或者先把旧表改名备份（ALTER TABLE employees RENAME TO employees_bak;）再恢复。生产环境我更推荐第三种，留个后路总没错。
第二个是权限问题。pg_restore以哪个用户连接，就以哪个用户的身份执行SQL，所以该用户需要对目标库有CREATE权限，对目标schema有USAGE和CREATE权限。如果表有序列、触发器等依赖对象，恢复数据时可能还需要序列的权限。遇到ownership报错可以加--no-owner，跳过设置对象属主的语句：
# 恢复时不执行owner设置和权限授予语句，避免权限报错 pg_restore -d mydb -t employees --no-owner --no-privileges /path/to/backup.dump
第三个坑是依赖对象缺失。单表恢复只恢复这一张表，但如果表上有外键引用了别的表，或者有自定义类型、函数，恢复就会失败。处理办法是用多个-t把依赖的表一起恢复，或者先手动创建依赖对象。如果只是恢复数据且外键约束还在，还要注意数据插入顺序，被依赖的表数据得先就位。
最后补充几个实用参数：-j 4可以开4个并行任务加速大表恢复（注意并行恢复时输出目标必须是库而不是文件）；-v显示详细过程方便排查卡在哪一步；-h和-p指定远程主机和端口，pg_restore完全支持远程恢复，只要网络通、认证配置没问题就行。把这些参数组合起来，单表恢复基本可以覆盖日常所有的误操作抢救场景。
pg_restorePostgreSQL单表恢复数据库备份恢复修改时间：2026-09-14 05:34:34