pg_restore [ -a ] [ -c ] [ -C ] [ -d dbname ] [ -f archive-file ] [ -F format ] [ -i index ] [ -l ] [ -L contents-file ] [ -N | -o | -r ] [ -O ] [ -P function-name ] [ -R ] [ -s ] [ -S ] [ -t table ] [ -T trigger ] [ -v ] [ -x ] [ -h host ] [ -p port ] [ -u ] [ archive-file ]
pg_restore 是一种用于恢复由 倾倒的任何非纯文本输出格式中 Postgres 数据库的应用．
归档（备份）文件是 7.1 版本新生成的，包含 pg_restore 用于重建数据库的足够的信息， 而且还允许pg_restore 有选择地进行恢复， 甚至在恢复前重新排列条目的顺序．归档的文件设计成可以在不同的硬件体系 之间移植．pg_dump 将生成那些重新生成 所有用户定义类型所需要的查询，函数，表，索引，聚集和操作符． 另外，所有数据都被拷贝出来了（以方便建立脚本的文本格式）， 这样它们就可以很容易的再次拷贝进来．
pg_restore 读取归档文件然后以所要求的顺序输出 基于命令行参数合适的 SQL．显然，它不能恢复那些没有在倾倒文件中出现的信息； 所以如果倾倒是使用把数据倾倒为插入语句选项做的， pg_restore 将不能使用 COPY 语句装载数据．
最灵活的输出文件格式是新的“客户”格式 （-Fc）． 它允许选择和恢复 所有归档的项目，而且缺省是压缩的． tar(-Ft) 格式是不压缩的并且它不可能调整数据装载的顺序， 但它也是很灵活的格式．
要对项目重新排序，首先必须倾倒归档的内容：
$ pg_restore archive.file -l > archive.list这个文件由一行头和每个项目一行组成，比如．
; ; Archive created at Fri Jul 28 22:28:36 2000 ; dbname: birds ; TOC Entries: 74 ; Compression: 0 ; Dump Version: 1.4-0 ; Format: CUSTOM ; ; ; Selected TOC Entries: ; 2; 145344 TABLE species postgres 3; 145344 ACL species 4; 145359 TABLE nt_header postgres 5; 145359 ACL nt_header 6; 145402 TABLE species_records postgres 7; 145402 ACL species_records 8; 145416 TABLE ss_old postgres 9; 145416 ACL ss_old 10; 145433 TABLE map_resolutions postgres 11; 145433 ACL map_resolutions 12; 145443 TABLE hs_old postgres 13; 145443 ACL hs_old这里分号是注释分隔符，而行开头的数字代表赋给每个项目的内部归档 ID．
文件内的行可以注释掉，删除和/或重新排列．比如，
10; 145433 TABLE map_resolutions postgres ;2; 145344 TABLE species postgres ;4; 145359 TABLE nt_header postgres 6; 145402 TABLE species_records postgres ;8; 145416 TABLE ss_old postgres可以用做 pg_restore 的输入并且只会 恢复项目 10 和 6，（以这个顺序）．
$ pg_restore archive.file -L archive.list
pg_restore 接受下列命令行参数 (长选项只有在一些平台上可用)：
声明要恢复的备份文件的位置． 如果没有声明而且没有使用 -f选项， 则使用标准输入．
只恢复数据，而不恢复表大纲（定义）．
创建表大纲前先清理（删除）它们．
报含创建表大纲的 SQL．
与数据库 dbname 联接并且直接恢复到该数据库中．BLOB 只能通过与数据库直接联接才能恢复．
声明生成的脚本的输出文件(与-l选项共用)， 缺省是标准输出．
声明备份文件的格式．因为pg_restore 会自动判断格式，所以如果声明了，它可以是下面之一：
备份是一个 tar 归档． 使用这个格式允许在恢复数据库的时候 重新排序和/或把表大纲元素排除出去． 同时还可能在恢复的时候限制重载的数据．
备份的格式是来自pg_dump的客户化格式． 这是最灵活的格式，因为 它允许重新对数据排序，也允许重载表大纲元素． 缺省时这个格式是压缩的．
只为名为 index 恢复定义．
列出备份的内容．这条命令的输出可以用 -L 选项限制和重排 所恢复的项目．
只恢复在 list-file 里面的元素，以它们在文件中出现的顺序．你可以移动各个行并且也可以 通过在行开头放 ';' 的方式注释．
以最初的倾倒顺序恢复项目．缺省时 pg_dump会以自己方便的顺序 倾倒项目，然后把备份保存为 OID 顺序被修改过的形式． 这个选项覆盖了 OID 的排序．
以 OID 顺序恢复项目．缺省时 pg_dump会以自己方便的顺序倾倒项目， 然后以这个变化了的 OID 顺序保存备份．这个选项强制严格的 OID 顺序．
防止任何恢复原来对象所有者的企图．对象将由与数据库相联的用户所有．
声明一个要恢复的过程或者函数．
以修改了的 OID 顺序恢复项目．缺省时 pg_dump会以自己方便的顺序倾倒项目， 然后以这个变化了的 OID 顺序保存备份． 大多数对象将以 OID 顺序恢复，但有些东西（比如，规则和索引）会在 过程的最后恢复，而不管它们的 OID 是什么．这个选项是缺省的．
如果与数据库直接联接了， 禁止 pg_restore 发出任何
\connect语句或者重新与数据库联接的动作．
恢复表结构（定义）．不恢复数据，序列值将重置．
当关闭触发器和/或设置表结构元素时声明超级用户的用户名． 缺省时，pg_restore 将使用当前用户名做 它的超级用户．
只恢复表 table 的大纲/数据．
只恢复触发器 trigger 的定义．
声明冗余模式．
避免 ACL 的恢复（grant/revoke 命令）．
pg_restore 还接受下面的命令行参数 做为联接参数：
声明 postmaster 运行的机器的主机名． 如果主机名以斜扛开头，那么它被用做 Unix 域套接字的目录．
声明 postmaster 侦听的 TCP/IP 端口 或者本地的 Unix 域套接字文件扩展．缺省的端口是 5432，或者 环境变量 PGPORT 的值（如果设置了的话）．
使用口令认证，提示输入用户名和口令．
Connection to database 'template1' failed.
connectDBStart() -- connect() failed: No such file or directory
Is the postmaster running locally
and accepting connections on Unix socket '/tmp/.s.PGSQL.5432'?pg_restore 无法与在声明的主机和端口上运行的 postmaster 联接． 如果你看到这条信息，确保 postmaster 在正确的主机和你声明的正确的端口上运行．如果你的节点使用某种认证系统， 确保你已经获取了认证需要的细节．
注意: 当使用 -d 选项声明了直接数据库联接时， pg_restore 在内部执行 SQL 语句．如果你运行 pg_restore 出了毛病， 请确保你能用类似 psql 这样的东西 从数据库中选取信息．
pg_restore 的局限在下面列出．
当向一个表恢复数据时，pg_restore 在插入数据前放出一些查询关闭用户表上的触发器，在数据插入完成后 重新打开它们．如果恢复的中途停止，那么系统表可能处于错误状态．
pg_restore 将不会为单一的表恢复 BLOB． 如果一个归档包含 BLOB，那么所有 BLOB 都将被恢复．
参阅 的文挡获取有关 pg_dump 的局限的细节．