一、概述
pg_restore 是一个用来从 pg_dump 创建的非文本格式文件中恢复 PostgreSQL 数据库的工具。
二、语法
pg_restore [connection-option] [option] filename
connection-option 可选参数：
-h host 或 --host=host：连接地址。
-p port 或 --port=port：连接端口号。
-U username 或 --username=username：连接用户。
-w 或 --no-password：不输入密码，这个选项对于批处理任务和脚本有用。
-W 或 --password：强制输入密码，在某些情况下，值得键入-W来避免额外的连接尝试。
–role=rolename：-U指定用户权限不足以恢复数据时，可设置其他角色权限来协助恢复。
option 可选参数：
-a 或 --data-only：只恢复数据，不恢复数据定义，大对象和序列值也会被恢复。
-c 或 --clean：在重新创建数据库对象之前清除它们。
-C 或 --create：在恢复一个数据库之前先创建它。如果还指定了–clean，在连接到目标数据库之前重建它。
-d dbname 或 --dbname=dbname：连接到数据库dbname并且直接恢复到该数据库中。
-e 或 --exit-on-error：恢复期间碰到错误就退出，默认恢复结束时显示一个错误计数。
-f filename 或 --file=filename：为生成的脚本指定输出文件，或在与-l选项一起使用时为列表指定输出文件
-F format 或 --format=format：指定归档的格式。
-I index 或 --index=index：只恢复提及的索引的定义，可以通过写多个-I开关指定多个索引。
-j number-of-jobs 或 --jobs=number-of-jobs：使用并发任务运行 pg_restore，这个选项只支持自定义和目录归档格式，输入必须是一个常规文件或目录。
-l 或 --list：列出归档的内容的表格。这个操作的输出能被用作-L选项的输入。注意如果把-n或-t这样的过滤开关与-l一起使用，它们将会限制列出的项。
-L list-file 或 --use-list=list-file：只恢复在list-file中列出的归档元素，并且按照它们出现在该文件中的顺序进行恢复。注意如果把-n或-t这样的过滤开关与-L一起使用，它们将会进一步限制要恢复的项。
-n shcema 或 --schema=schema：只恢复在被提及的模式中的对象。可以用多个-n开关来指定多个模式。这可以与-t选项组合在一起只恢复一个指定的表。
-N schema 或 --exclude-schema=schema：不恢复所提及方案中的对象。可以用多个-N开关指定多个要被排除的方案，优先级高于 -n。
-O 或 --no-owner：恢复时排除原库 owner。
-P function-name(argtype [, …]) 或–function=function-name(argtype [, …])：只恢复被提及的函数，可以使用多个-P开关指定多个函数。
-s 或 --schema-only：只恢复数据定义，不恢复数据。
-S username 或 --superuser=username：指定在禁用触发器时要用的超级用户名。只有使用–disable-triggers时这个选项才相关。
-t table 或 --table=table：只恢复所提及的表，“table”包括视图、物化视图、序列和外部表。
-T trigger 或 --trigger=trigger：只恢复所提及的触发器，可以用多个-T开关指定多个触发器。
-v 或 --verbose：指定冗长模式。
-V 或 --version：打印该pg_restore的版本并退出。
-x 或 --no-privileges 或 --no-acl：阻止恢复访问特权（授予/收回命令）。
-1 或 --single-transaction：将恢复作为单一事务执行（即把发出的命令包裹在BEGIN/COMMIT中），这个选项隐含了–exit-on-error。
–disable-triggers：只有在执行一个只恢复数据的恢复时，这个选项才相关。它指示pg_restore在装载数据时执行命令临时禁用目标表上的触发器。目前，为–disable-triggers发出的命令必须以超级用户身份完成。因此你还应该用-S指定一个超级用户名，或者更好的方法是以一个PostgreSQL超级用户运行pg_restore。
–enable-row-security：只有在恢复具有行安全性的表的内容时，这个选项才相关。默认情况下，pg_restore将把row_security设置为 off 来确保所有数据都被恢复到表中。注意当前这个选项还要求转储处于INSERT格式，因为COPY FROM不支持行安全性。
–if-exists：使用条件命令（即增加一个IF EXISTS子句）删除数据库对象。只有指定了–clean时，这个选项才有效。
–no-comments：不输出恢复注释的命令。
–no-data-for-failed-tables：默认情况下，即便表的创建命令失败（例如因为表已经存在），表数据也会被恢复。通过这个选项，对这类表的数据会被跳过。只有当直接恢复到一个数据库中时这个选项才有效，在产生 SQL脚本输出时这个选项不会产生效果。
–no-publications：不输出恢复publication的命令。
–no-security-labels：不输出恢复安全标签的命令。
–no-subscriptions：不输出恢复subscription的命令。
–no-tablespaces：不输出命令选择表空间。通过这个选项，所有的对象都会被创建在恢复时的默认表空间中。
–section=sectionname：只恢复提及的小节。小节的名称可以是pre-data、data或者post-data。可以把这个选项指定多次来选择多个小节。默认值是恢复所有小节。 数据小节包含实际的表数据以及大对象定义。Post-data 项由索引定义、触发器、规则和除已验证的检查约束之外的约束构成。Pre-data 项由所有其他数据定义项构成。
–strict-names：要求每一个模式（-n/–schema）以及表（-t/–table）限定词匹配备份文件中至少一个模式/表。
–use-set-session-authorization：输出 SQL 标准的SET SESSION AUTHORIZATION命令取代ALTER OWNER命令来决定对象拥有权。这会让转储更加兼容标准，但是依赖于转储中对象的历史，可能无法正确恢复。
三、示例
--备份数据库
pg_dump -Fc -d test > test.dump
--删除数据库
dropdb test
--恢复到原数据库
pg_restore test.dump -d highgo -C
--恢复到其他数据库
pg_restore test.dump -d ddd
--dump二进制文件转为sql文本文件
pg_restore test.dump -C -f test.sql
--dump二进制文件转为列表文本
pg_restore -l test.dump > test.list
--编辑列表文本，排除恢复对象恢复（对应的对象行首加;即为排除该对象）
pg_restore -L test.list test.dump -C -d highgo
如排除表 sssss 恢复：
[highgo@dj ~]$ more test.list
;
; Archive created at 2022-02-23 17:31:42 CST
; dbname: test
; TOC Entries: 14
; Compression: -1
; Dump Version: 1.13-0
; Format: CUSTOM
; Integer: 4 bytes
; Offset: 8 bytes
; Dumped from database version: 10.6
; Dumped by pg_dump version: 10.6
;
;
; Selected TOC Entries:
;
3713; 1262 16441 DATABASE - test highgo
2; 3079 13205 EXTENSION - oraftops
3714; 0 0 COMMENT - EXTENSION oraftops
7; 2615 2200 SCHEMA - public highgo
3715; 0 0 COMMENT - SCHEMA public highgo
1; 3079 13200 EXTENSION - plpgsql
3716; 0 0 COMMENT - EXTENSION plpgsql
3; 3079 13843 EXTENSION - alter_pg_func
3717; 0 0 COMMENT - EXTENSION alter_pg_func
;211; 1259 16442 TABLE public sssss highgo
;3707; 0 16442 TABLE DATA public sssss highgo