PostgreSQL
上一页 下一页

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 > db.out
要重载该数据库： 
% psql -e database < db.out
上一页 首页 下一页
pg_ctl 开头 pg_dumpall