pg_restore - 从一个由 pg_dump 创建的备份文件中恢复 PostgreSQL 数据库。

SYNOPSIS

pg_restore [ option...] [ filename]

DESCRIPTION 描述

pg_restore 是一种用于恢复由 pg_dump(1) 创建的任何非纯文本输出格式中的 PostgreSQL 数据库的应用。 它将发出必要的命令来重新构造数据库,以便于把它恢复成保存它的时候的样子。 归档(备份)文件还允许pg_restore 有选择地进行恢复, 甚至在恢复前重新排列条目的顺序。归档的文件设计成可以在不同的硬件体系之间移植。

pg_restore 可以以两种模式操作:如果声明了数据库名字, 那么归档是直接恢复到数据库里。大对象只能用直接数据库联接进行恢复。 否则,先创建一个包含重建数据库所必须的 SQL 命令的脚本(并且写入到一个文件或者标准输出), 类似 pg_dump 输出纯文本格式的时候创建的那种脚本。 因此,一些控制脚本输出的选项就是摹拟 pg_dump 的操作。

显然,pg_restore 无法恢复那些不存在归档文件中的信息; 比如,如果归档是用"把数据转储为 INSERT命令"选项制作的, 那么 pg_restore 将不能使用 COPY 语句装载数据。

OPTIONS 选项

pg_restore 接受下列命令行参数。

filename
声明要恢复的备份文件的位置。如果没有声明,则使用标准输入。
-a
--data-only
只恢复数据,而不恢复表模式(数据定义)。
-c
--clean
创建数据库对象前先清理(删除)它们。
-C
--create
在恢复数据库之前先创建它。(如果出现了这个选项,和 -d 在一起的数据库名只是用于发出最初的 CREATE DATABASE 命令。 所有数据都恢复到名字出现在归档中的数据库中去。)

-d dbname
--dbname=dbname
与数据库 dbname 联接并且直接恢复到该数据库中。
-f filename
--file=filename
声明生成的脚本的输出文件,或者出现 -l 选项时用于列表的文件,缺省是标准输出。
-F format
--format=format
声明备份文件的格式。因为pg_restore 会自动判断格式,所以如果声明了,它可以是下面之一:

t
备份是一个 tar 归档。 使用这个格式允许在恢复数据库的时候重新排序和/或把表模式元素排除出去。 同时还可能在恢复的时候限制装载的数据。
c
备份的格式是来自 pg_dump 的客户化格式。 这是最灵活的格式,因为它允许重新对数据排序,也允许重载表模式元素。 缺省时这个格式是压缩的。
-i
--ignore-version
忽略数据库版本检查。
-I index
--index=index
只恢复命名的索引。
-l
--list
列出备份的内容。这个操作的输出可以用 -L 选项限制和重排所恢复的项目。
-L list-file
--use-list=list-file
只恢复在 list-file 里面的元素,以它们在文件中出现的顺序。 你可以移动各个行并且也可以通过在行开头放 ‘;‘ 的方式注释。(见下文获取例子。)

-N
--orig-order
以最初在 pg_dump 里生成的转储顺序恢复项目。 这个选项没有什么实际的用途,因为 pg_dump 会以自己方便的顺序生成项, 这个顺序不可能是恢复这些数据的安全顺序。 (这个顺序不是项最后在归档的内容列表中列出的顺序。) 又见 -r。

-o
--oid-order
以 OID 顺序恢复项目。这个选项用处很小, 因为 OID 只是最初创建顺序的一个近似指示。 如果还声明了 -N,那么这个选项还覆盖它。又见 -r。

-O
--no-owner
不要输出设置对象的权限,以便与最初的数据库匹配的命令。 缺省时,pg_restore 发出 SET SESSION AUTHORIZATION 语句设置创建出来的模式元素的所有者权限。 如果最初的数据库连接不是由超级用户(或者是拥有所有创建出来的对象的同一个用户)发起的,那么这些语句将失败。 使用 -O,那么任何用户都可以用于初始的连接,并且这个用户将拥有所有创建出来的对象。

-P function-name(argtype [, ...])
--function=function-name(argtype [, ...])
只恢复指定的命名函数。请注意仔细拼写函数名及其参数,应该和转储的内容列表中的完全一样。
-r
--rearrange
以对象类型重排项目(这个发生在以 -N 或者 -o 排序之后)。 重排是为了给出最大可能的性能。

如果没有 -N, -o, and -r,那么 pg_restore 以项目出现在归档的内容列表中的顺序恢复他们,
或者按照他们在 list-file 里面的顺序恢复他们——假如给出了 -L 的话。 -o 和 -r 的组合复制了 pg_dump
在创建归档的内容列表之前进行的排序, 因此,这个选项通常没必要声明。

-R
--no-reconnect
这个选项已经废弃了,但是为了保持向下兼容仍然接受。
-s
--schema-only
只恢复表结构(数据定义)。不恢复数据,序列值将重置。
-S username
--superuser=username
设置关闭触发器时声明超级用户的用户名。 只有在设置了 --disable-triggers 的时候才有用。
-t table
--table=table
只恢复表指定的表的定义和/或数据。
-T trigger
--trigger=trigger
只恢复指定的触发器。
-v
--verbose
声明冗余模式。
-x
--no-privileges
--no-acl
避免 ACL 的恢复(grant/revoke 命令)。
-X use-set-session-authorization
--use-set-session-authorization
这个选项已经废弃了,但是出于向下兼容,仍然接受。 pg_restore 现在总是表现得像以前选中这个选项一样。
-X disable-triggers
--disable-triggers
这个选项只有在执行仅恢复数据的时候才相关。它告诉 pg_restore 在装载数据的时候执行一些命令临时关闭在目标表上的触发器。 如果你在表上有完整性检查或者其它触发器, 而你又不希望在装载数据的时候激活它们,那么可以使用这个选项。

目前,为 --disable-triggers 发出的命令必须以超级用户发出。 因此,你应该也要用 -S 声明一个超级用户名,或者更好是设置 --use-set-session-authorization 并且以 PostgreSQL 超级用户身份运行 pg_restore。

pg_restore 还接受下面的命令行参数做为联接参数:

-h host
--host=host
声明服务器运行的机器的主机名。 如果数值以斜扛开头,那么它被用做 Unix 域套接字的目录。 缺省是从 PGHOST 环境变量中获取的(如果设置了), 否则将尝试进行 Unix 域套接字。

-p port
--port=port
声明服务器侦听的 TCP 端口或者本地的 Unix 域套接字文件扩展。 缺省是环境变量 PGPORT 的值(如果设置了的话), 否则就说编译的缺省。

-U username
以给出用户身分联接。
-W
强制给出口令提示。如果服务器要求口令认证,那么这个应该自动发生。

ENVIRONMENT 环境

PGHOST
PGPORT
PGUSER
缺省连接参数。

DIAGNOSTICS 诊断

当使用-d选项声明了直接数据库联接时, pg_restore 在内部执行 SQL 语句。如果你运行 pg_restore 出了毛病, 请确保你能用类似 psql(1) 这样的东西从数据库中选取信息。

NOTES 注意

如果你的安装给template1数据库增加了任何你自己的东西, 那么请注意把 pg_dump 的输出恢复到一个真正空的数据库中; 否则你可能会收到因为重复定义所追加的对象而造成的错误信息。要制作一个没有任何本地附属物的数据库, 可以从template0而不是template1拷贝,比如:

CREATE DATABASE foo WITH TEMPLATE template0;

pg_restore 的局限在下面列出。

*
当向一个已经存在的表恢复数据,并且还使用了 --disable-triggers 选项时, pg_restore 在插入数据前放出一些查询关闭用户表上的触发器, 在数据插入完成后重新打开它们。如果恢复的中途停止,那么系统表可能处于错误状态。

*
pg_restore 将不会为单一的表恢复大对象。 如果一个归档包含大对象,那么所有大对象都将被恢复。

又见参阅 pg_dump(1) 的文挡获取有关 pg_dump 的局限的细节。

一旦完成恢复,最好在每个恢复的对象上运行 ANALYZE, 以便给优化器有用的统计。

EXAMPLES 例子

把一个包含大对象的叫 mydb 的数据库转储到一个tar文件:

$ pg_dump -Ft -b mydb > db.tar

把这个数据库恢复到现有的叫 newdb 的数据库中(连同BLOB):

$ pg_restore -d newdb db.tar

要对项目重新排序,首先必须转储归档的目录:

$ pg_restore -l archive.file > 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 -L archive.list archive.file

原文地址:https://www.cnblogs.com/fanweisheng/p/11097507.html

时间: 2024-10-13 04:54:02

pg_restore - 从一个由 pg_dump 创建的备份文件中恢复 PostgreSQL 数据库。的相关文章

Windows Azure上的Odoo(OpenERP)-1.创建Ubuntu虚拟机,安装PostgreSQL 数据库

前提是您必须拥有Windows Azure的账号,如果没有的话,可以去Windows Azure 中国区网站申请免费试用账号.哈哈,我就是第一批申请的试用账号,感觉自己挺幸运的.申请的过程就不写了,请自行Google! 哦,对不起(GFW),请自行百度. 首先请登录Windows Azure,然后我们来大踏步的前进吧! 1.首先让我们创建一个运行Ubuntu操作系统的虚拟机 点击界面左下角的"新建"   会弹出一个对话框,让你选择新建运行何种操作系统的虚拟机 我选择的Ubuntu Se

ubuntu 下搭建一个python3的虚拟环境(用于django配合postgresql数据库开发)

#安装python pip  (在物理环境中安装) sudo apt-get install python-pip       sudo apt-get install python3-pipsudo pip install --upgrade pipsudo pip3 install --upgrade pip 备注说明: python-pip 是python2版本的包管理工具   , python3-pip是python3版本的包管理工具 ,  如果你创建了一个python2的虚拟环境 ,当

PostgreSQL数据库pg_dump命令行不输入密码的方法

对于PostgreSQL数据库的备份按照官方手册的方法之一就是采用"SQL Dump"的方式(另一种方式是直接备份文件系统中的文件,可参考官方手册). 基本用法如下: pg_dump dbname > outfile 首先,正如命令行所展示的,pg_dump是将命令结果输出到标准输出中. 其次,pg_dump并不影响数据库工作过程中的其他操作(主要是关心pg_dump会不会产生读写锁(read lock.write lock)),但也有例外,那就是哪些需要使用互斥锁(exclus

C#在某个线程上创建的控件不能成为在另一个线程上创建的控件的父级

首先在form1的窗体载入中新建了一个Class1对象并将本身的引用传递进入其构造函数,然后在Class1的构造函数中创建一个线程.该线程所代理的方法事件是本类中的一个add方法.而add方法的内容则是在form1上放一个textbox.然而这个流程你需要注意的有几个问题:1.哪个是主线程?所谓主线程是第一个启动的线程,是从main开始的.form1的这个窗体是由主线程创建的.2.Thread t的线程是什么?t是由主线程创建的,t的操作内容是在由主线程创建的窗体上放一个textbox.也就是说

OrmLite动态创建表,一个实体类创建多张表的的偏招

在做一个Android的项目,因为使用数据库频繁,实体字段也比较多,于是打算采用ORM框架,发现OrmLite还不错,于是下了下来,打算使用. 没想到还没正式开工,就遇到问题了.我现在的一个需求如下, 我有一个实体类如下,代表聊天消息,现在要做的是针对每一个当前用户(userId)对应一个朋友(friendId)都要创建一个表.需求比较蛋疼,我本来想的是直接在加两个字段就搞定的,但是我们老大说要分表.没办法只能分表. public class ChatMessage{ public ChatMe

java 加入一个线程、创建有响应的用户界面 。 示例代码

javajava 加入一个线程.创建有响应的用户界面 . 示例代码 来自thinking in java 4 21章  部分代码  目录21.2.11 thinking in java 4免费下载:http://download.csdn.net/detail/liangrui1988/7580155 package org.rui.thread.concurrent; /** * 加入一个线程 * 一个线程可以在其他线程之上调用join()方法,其效果是等待一段时间直到第二个线程结束才继续执行

classmethod一个用处是创建可选类构造器

Definition and Introduction通常来说, descriptor 是一种绑定着特殊行为属性的对象, 在访问它时行为被descriptor协议定义的方法所重载.这些方法是__get__, __set__ 和__delete__. 如果对象定义了任一方法,这个对象就被叫做descriptor.访问对象的属性默认行为是get, set或delete对象字典中的属性.例如, a.x查找路径是从a.__dict__['x']开始,然后是type(a).__dict__['x'],并继

Android NDK:②第一个NDK程序(创建步骤&一些问题)

Android NDK:②第一个NDK程序(创建步骤&一些问题) 本节内容是:演示搭建第一个NDK程序 Android NDK第一个NDK程序创建步骤一些问题 创建一个Android Project Java代码中声明native方法 创建Jni文件夹编写ccpp代码 为项目添加NDK支持 新建配置一个Builder 调用了native方法的地方加载库 好了把程序跑起来 总结 遇到的问题 1.创建一个Android Project 直接创建一个新的Android Application Proj

java如何在文件中读取一个字符串并创建以这个字符为名字的类的对象

<span style="font-family: Arial, Helvetica, sans-serif; background-color: rgb(255, 255, 255);">我们一般用properties或者XML文件作为资源存储的文件,现在主要介绍一下对properties的操作</span> 1.我们在src文件下新建一个名称为config的包 2.在config下新建一个file,把它命名为demo.properties 3. 把下面的几段