PostgreSQL7.0手册-用户手册-20. 应用 - pg_dump

pg_dump
名称
pg_dump　—　将一个　Postgres　数据库抽出到一个脚本文件　

语法
pg_dump　[　dbname　]
pg_dump　[　-h　host　]　[　-p　port　]
　　　　[　-t　table　]
　　　　[　-a　]　[　-c　]　[　-d　]　[　-D　]　[　-i　]　[　-n　]　[　-N　]
　　　　[　-o　]　[　-s　]　[　-u　]　[　-v　]　[　-x　]
　　　　[　dbname　]

输入
pg_dump　接受下面的命令行参数：　
　　
dbname　
声明将要抽取的数据库名．dbname　缺省为　USER　环境变量的值．　
　　
-a　
只输出数据，不输出结构（表定义）．　
-c　
创建前删除表定义。　
-d　
将数据输出为合适的插入字串．　
-D　
将数据作为带字段名的插入语句输出．　
-i　
忽略在　　pg_dump　和数据库服务器之间的版本差别．因为　pg_dump　知道许多关于系统表的信息，任何给定版本的　pg_dump　只能和对应的数据库服务器版本一并使用．如果你需要跨越版本检查时才使用这个选项（而且如果　pg_dump　失效，别说我没警告你）．　
-n　
除非绝对必需，禁止标识周围的双引号．如果有保留字用于标识符，这么做有可能在装载输出的数据时导致麻烦．这是　v6.4以前的　pg_dump　缺省特性。　
-N　
在标识周围包括双引号。这是缺省。　
-o　
为每个表都输出对象标识（OID）．　
-s　
只输出表结构（定义），不输出数据．　
-t　table　
只输出表　table　的数据．　
-u　
使用口令认证．提示输入用户名和口令．　
-v　
声明冗余模式　
-x　
避免输出　ACL（赋予/撤消　命令）和表的所有者关系信息．　
pg_dump　同样接受下面的命令行参数作为联接参数：　
-h　host　
声明　postmaster　在运行的机器的主机名．缺省是使用本地Unix主控套接字，而不是一个　IP　联接．　
-p　port　
声明　postmaster　正在侦听并等待联接的TCP/IP　端口或本地　Unix　主控套接字文件句柄．缺省的端口号是5432，或者环境变量　PGPORT　的值（如果存在）．　
-u　
使用口令认证，提示输入　username　和　password．　

输出
pg_dump　将创建一个文件或输出到　stdout。　
　　
Connection　to　database　'template1'　failed.　connectDB()　failed:　Is　the　postmaster　running　and　accepting　connections　at　'UNIX　Socket'　on　port　'port'?　
　　
pg_dump　无法与指定主机和端口上的　postmaster　进程相联．如果看到这条信息，确认　postmaster　正在给定的主机上你所声明的端口上运行．如果你的节点使用了认证系统，确认你已经获取了认证所须的信息．　
　　
Connection　to　database　'dbname'　failed.　FATAL　1:　SetUserId:　user　'username'　is　not　in　'pg_shadow'　
你在　pg_shadow　和　里没有有效的记录，因而不允许访问　Postgres．请与你的　Postgres　管理员联系．　
dumpSequence(table):　SELECT　failed　
你没有读数据库的权限．请与你的　Postgres　节点管理员联系．　

注意：pg_dump　在内部使用　SELECT　语句．如果你运行　pg_dump　时碰到问题，确认你能够使用象　psql　这样的程序从数据库选择．
描述
pg_dump　是一个将　Postgres　数据库输出到一个包含查询命令的脚本文件的工具．脚本文件是文本格式并且可以用于重建数据库，甚至可以在其他机器或其他硬件体系上．pg_dump　将输出用于重建所有用户定义的类型，函数，表，索引聚集和操作符所必须的查询语句．另外，所有数据是用文本格式拷贝出来的，因而也可以很容易地拷贝回去，也很容易用工具编辑．　
pg_dump　在从　Postgres　节点向另一个节点一个转移数据时很有用．在运行pg_dump　后，我们应该检查输出脚本中的任何警告，尤其是下面列出的限制．

注意
pg_dump　有一些限制．限制主要源于从系统表中抽取某些专有信息的困难性．　
pg_dump　不能理解部分索引．原因与上面所述相同；部分索引谓词都作为规划存储．（　predicates　are　stored　as　plans．）　
pg_dump　不能处理大对象．大对象被忽略因而必须手工操作．　

当只做数据输出时，pg_dump　使用查询在插入数据前关闭用户表上的触发器以及在重新插入数据后恢复．如果重载在途中停止，系统表可能停留在错误的状态．　


用法
输出与用户名同名的数据库：　
%　pg_dump　>　db.out

要重载该数据库：　
%　psql　-e　database　<　db.out