PostgreSQL7.0手册-用户手册-20. 应用 - pg_dump
2019-09-08 23:33:30
供稿：网友
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
