PostgreSQL 数据库导入导出

前言

PostgreSQL 使用 pg_dump 和 pg_dumpall 进行数据库的逻辑备份，使用 pg_restore 导入数据，pg_dumpall 是对整个数据库集群进行备份，pg_dump 可以选择一个数据库或者部分表进行备份。

关于 pg_dump:

• pg_dump 将表结构及数据以 SQL 语句的形式导出到 sql 文件或其他格式文件，恢复数据时，将导出的文件作为输入，执行其中的 SQL 语句，即可恢复数据。

• pg_dump 能够对正在使用的 PostgreSQL 数据库进行备份，并且不影响正常业务的读写。

• pg_dump 是一个客户端工具，可以远程或本地导出逻辑数据，恢复数据至导出时间点。

• pg_dump 一次只转储一个数据库，并不会转储有关角色或表空间的信息 (因为那些是群集范围而不是每个数据库)。

关于 pg_dumpall：

• 如果要备份 Cluster 中数据库共有的全局对象，例如角色和表空间，需要使用 pg_dumpall。

• 备份文件以文本或存档文件格式输出。

• Script dumps 是一个普通文本文件，包含将数据库重构到保存时的状态所需的 SQL 命令。

• pg_dumpall 在给定的群集中备份每个数据库, 并保留群集范围内的数据, 如角色和表空间定义。

pg_dump 常用参数

• -h host，指定数据库主机名，或者IP
• -p port，指定端口号
• -U user，指定连接使用的用户名
• -W，按提示输入密码
• dbname，指定连接的数据库名称，实际上也是要备份的数据库名称。
• -a，–data-only，只导出数据，不导出表结构
• -c，–clean，是否生成清理该数据库对象的语句，比如drop table
• -C，–create，是否输出一条创建数据库语句
• -f file，–file=file，输出到指定文件中
• -n schema，–schema=schema，只转存匹配schema的模式内容
• -N schema，–exclude-schema=schema，不转存匹配schema的模式内容
• -O，–no-owner，不设置导出对象的所有权
• -s，–schema-only，只导致对象定义模式，不导出数据
• -t table，–table=table，只转存匹配到的表，视图，序列，可以使用多个-t匹配多个表
• -T table，–exclude-table=table，不转存匹配到的表。
• –inserts，使用insert命令形式导出数据，这种方式比默认的copy方式慢很多，但是可用于将数据导入到非PostgreSQL数据库。
• –column-inserts，导出的数据，有显式列名

pg_dump 常用示例

1.1 导出单表数据

pg_dump -h 127.0.0.1 -U admin -p 5432 -W db -t t1 –inserts > bak.sql

1.2 导出多个表数据

pg_dump -h 127.0.0.1 -U admin -p 5432 -W db -t t1 -t t2 –inserts > bak.sql

1.3 导出整个数据库

pg_dump -h 127.0.0.1 -U admin -p 5432 -W db –inserts > bak.sql

1.4 只导出表结构，不导出数据

pg_dump -h 127.0.0.1 -U admin -p 5432 -W db -s > bak.sql

1.5 只导出数据，不导出表结构

pg_dump -h 127.0.0.1 -U admin -p 5432 -W db –inserts -a > bak.sql

pg_dump 工具参数

pg_dump --help
pg_dump 把一个数据库转储为纯文本文件或者是其它格式.
 
用法:
  pg_dump [选项]... [数据库名字]
 
一般选项:
  -f, --file=FILENAME          输出文件或目录名
  -F, --format=c|d|t|p         输出文件格式 (定制, 目录, tar)
                               明文 (默认值))
  -j, --jobs=NUM               执行多个并行任务进行备份转储工作
  -v, --verbose                详细模式
  -V, --version                输出版本信息，然后退出
  -Z, --compress=0-9           被压缩格式的压缩级别
  --lock-wait-timeout=TIMEOUT  在等待表锁超时后操作失败
  --no-sync                    do not wait for changes to be written safely to disk
  -?, --help                   显示此帮助, 然后退出
 
控制输出内容选项:
  -a, --data-only              只转储数据,不包括模式
  -b, --blobs                  在转储中包括大对象
  -B, --no-blobs               exclude large objects in dump
  -c, --clean                  在重新创建之前，先清除（删除）数据库对象
  -C, --create                 在转储中包括命令,以便创建数据库
  -E, --encoding=ENCODING      转储以ENCODING形式编码的数据
  -n, --schema=SCHEMA          只转储指定名称的模式
  -N, --exclude-schema=SCHEMA  不转储已命名的模式
  -o, --oids                   在转储中包括 OID
  -O, --no-owner               在明文格式中, 忽略恢复对象所属者
 
  -s, --schema-only            只转储模式, 不包括数据
  -S, --superuser=NAME         在明文格式中使用指定的超级用户名
  -t, --table=TABLE            只转储指定名称的表
  -T, --exclude-table=TABLE    不转储指定名称的表
  -x, --no-privileges          不要转储权限 (grant/revoke)
  --binary-upgrade             只能由升级工具使用
  --column-inserts             以带有列名的INSERT命令形式转储数据
  --disable-dollar-quoting     取消美元 (符号) 引号, 使用 SQL 标准引号
  --disable-triggers           在只恢复数据的过程中禁用触发器
  --enable-row-security        启用行安全性（只转储用户能够访问的内容）
  --exclude-table-data=TABLE   不转储指定名称的表中的数据
  --if-exists              当删除对象时使用IF EXISTS
  --inserts                    以INSERT命令，而不是COPY命令的形式转储数据
  --load-via-partition-root    load partitions via the root table
  --no-comments                do not dump comments
  --no-publications            do not dump publications
  --no-security-labels         不转储安全标签的分配
  --no-subscriptions           do not dump subscriptions
  --no-synchronized-snapshots  在并行工作集中不使用同步快照
  --no-tablespaces             不转储表空间分配信息
  --no-unlogged-table-data     不转储没有日志的表数据
  --quote-all-identifiers      所有标识符加引号，即使不是关键字
  --section=SECTION            备份命名的节 (数据前, 数据, 及 数据后)
  --serializable-deferrable   等到备份可以无异常运行
  --snapshot=SNAPSHOT          为转储使用给定的快照
  --strict-names               要求每个表和/或schema包括模式以匹配至少一个实体
  --use-set-session-authorization
                               使用 SESSION AUTHORIZATION 命令代替
                ALTER OWNER 命令来设置所有权
 
联接选项:
  -d, --dbname=DBNAME       对数据库 DBNAME备份
  -h, --host=主机名        数据库服务器的主机名或套接字目录
  -p, --port=端口号        数据库服务器的端口号
  -U, --username=名字      以指定的数据库用户联接
  -w, --no-password        永远不提示输入口令
  -W, --password           强制口令提示 (自动)
  --role=ROLENAME          在转储前运行SET ROLE
 
如果没有提供数据库名字, 那么使用 PGDATABASE 环境变量
的数值.

pg_dumpall

pg_dump 只能备份单个库，pg_dumpall 可以备份整个 postgresql 实例中所有的数据，包括角色和表空间定义。

示例如下：

pg_dumpall -h 127.0.0.1 -U admin -p 5432 -W –inserts > bak.sql

pg_dumpall 工具参数

pg_dumpall --help
pg_dumpall 抽取一个 PostgreSQL 数据库簇进一个 SQL 脚本文件.
 
用法:
  pg_dumpall [选项]...
 
一般选项:
  -f, --file=FILENAME          输出文件名
  -v, --verbose                详细模式
  -V, --version                输出版本信息，然后退出
  --lock-wait-timeout=TIMEOUT  在等待表锁超时后操作失败
  -?, --help                   显示此帮助, 然后退出
 
控制输出内容选项:
  -a, --data-only              只转储数据,不包括模式
  -c, --clean                  在重新创建数据库前先清除(删除)数据库
  -E, --encoding=ENCODING      转储以ENCODING形式编码的数据
  -g, --globals-only           只转储全局对象, 不包括数据库
  -o, --oids                   在转储中包括 OID
  -O, --no-owner               不恢复对象所属者
  -r, --roles-only             只转储角色，不包括数据库或表空间
  -s, --schema-only            只转储模式, 不包括数据
  -S, --superuser=NAME         在转储中, 指定的超级用户名
  -t, --tablespaces-only       只转储表空间，而不转储数据库或角色
  -x, --no-privileges          不要转储权限 (grant/revoke)
  --binary-upgrade             只能由升级工具使用
  --column-inserts             以带有列名的INSERT命令形式转储数据
  --disable-dollar-quoting     取消美元 (符号) 引号, 使用 SQL 标准引号
  --disable-triggers           在只恢复数据的过程中禁用触发器
  --if-exists              当删除对象时使用IF EXISTS
  --inserts                    以INSERT命令，而不是COPY命令的形式转储数据
  --load-via-partition-root    load partitions via the root table
  --no-comments                do not dump comments
  --no-publications            do not dump publications
  --no-role-passwords          do not dump passwords for roles
  --no-security-labels         不转储安全标签的分配
  --no-subscriptions           do not dump subscriptions
  --no-sync                    do not wait for changes to be written safely to disk
  --no-tablespaces             不转储表空间分配信息
  --no-unlogged-table-data     不转储没有日志的表数据
  --quote-all-identifiers      所有标识符加引号，即使不是关键字
  --use-set-session-authorization
                               使用 SESSION AUTHORIZATION 命令代替
                ALTER OWNER 命令来设置所有权
 
联接选项:
  -d, --dbname=CONNSTR        连接数据库使用的连接串
  -h, --host=主机名        数据库服务器的主机名或套接字目录
  -l, --database=DBNAME    另一个缺省数据库
  -p, --port=端口号        数据库服务器的端口号
  -U, --username=名字      以指定的数据库用户联接
  -w, --no-password        永远不提示输入口令
  -W, --password           强制口令提示 (自动)
  --role=ROLENAME          在转储前运行SET ROLE

pg_restore 实例

#pg_restore恢复示例
pg_restore -h 192.168.0.100 -p 5432 -U postgres -W -d us2011 -v "/root/us2010.backup"

也可以直接使用 psql 执行 sql 文件

./psql -d databaseName -U postgres -f /Users/xxx/xx_dump.sql

-d 后面紧跟的为 数据库名
-U 后面紧跟的为 数据库用户名
-f 后面紧跟的为 sql文件路径，也就是备份的SQL语句。

pg_restore 数据导入工具

pg_restore --help
pg_restore 从一个归档中恢复一个由 pg_dump 创建的 PostgreSQL 数据库.
 
用法:
  pg_restore [选项]... [文件名]
 
一般选项:
  -d, --dbname=名字        连接数据库名字
  -f, --file=文件名        输出文件名
  -F, --format=c|d|t       备份文件格式(应该自动进行)
  -l, --list               打印归档文件的 TOC 概述
  -v, --verbose            详细模式
  -V, --version            输出版本信息, 然后退出
  -?, --help               显示此帮助, 然后退出
 
恢复控制选项:
  -a, --data-only             只恢复数据, 不包括模式
  -c, --clean                  在重新创建之前，先清除（删除）数据库对象
  -C, --create                 创建目标数据库
  -e, --exit-on-error          发生错误退出, 默认为继续
  -I, --index=NAME             恢复指定名称的索引
  -j, --jobs=NUM               执行多个并行任务进行恢复工作
  -L, --use-list=FILENAME      从这个文件中使用指定的内容表排序
                               输出
  -n, --schema=NAME            在这个模式中只恢复对象
  -N, --exclude-schema=NAME    do not restore objects in this schema
  -O, --no-owner               不恢复对象所属者
  -P, --function=NAME(args)    恢复指定名字的函数
  -s, --schema-only           只恢复模式, 不包括数据
  -S, --superuser=NAME         使用指定的超级用户来禁用触发器
  -t, --table=NAME             restore named relation (table, view, etc.)
  -T, --trigger=NAME          恢复指定名字的触发器
  -x, --no-privileges          跳过处理权限的恢复 (grant/revoke)
  -1, --single-transaction     作为单个事务恢复
  --disable-triggers           在只恢复数据的过程中禁用触发器
  --enable-row-security        启用行安全性
  --if-exists              当删除对象时使用IF EXISTS
  --no-comments                do not restore comments
  --no-data-for-failed-tables  对那些无法创建的表不进行
                               数据恢复
  --no-publications            do not restore publications
  --no-security-labels         不恢复安全标签信息
  --no-subscriptions           do not restore subscriptions
  --no-tablespaces             不恢复表空间的分配信息
  --section=SECTION            恢复命名节 (数据前、数据及数据后)
  --strict-names               要求每个表和/或schema包括模式以匹配至少一个实体
  --use-set-session-authorization
                               使用 SESSION AUTHORIZATION 命令代替
                ALTER OWNER 命令来设置所有权
 
联接选项:
  -h, --host=主机名        数据库服务器的主机名或套接字目录
  -p, --port=端口号        数据库服务器的端口号
  -U, --username=名字      以指定的数据库用户联接
  -w, --no-password        永远不提示输入口令
  -W, --password           强制口令提示 (自动)
  --role=ROLENAME          在恢复前执行SET ROLE操作
 
The options -I, -n, -N, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.