PostgreSQL -- 备份恢复命令

前言

这是我在这个网站整理的笔记，关注我，接下来还会持续更新。作者：RodmaChen

PostgreSQL -- 备份恢复命令

- - 一. pg_dump常用参数
  - 二. pg_dumpall
  - 三. psql
  - 四. pg_restore
  - 五.参考文章

PostgreSQL 13.7

一. pg_dump常用参数

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                    不用等待变化安全写入磁盘-?, --help                   显示此帮助, 然后退出控制输出内容选项:-a, --data-only              只转储数据,不包括模式-b, --blobs                  在转储中包括大对象-B, --no-blobs               排除转储中的大型对象-c, --clean                  在重新创建之前，先清除（删除）数据库对象-C, --create                 在转储中包括命令,以便创建数据库-E, --encoding=ENCODING      转储以ENCODING形式编码的数据-n, --schema=PATTERN         dump the specified schema(s) only-N, --exclude-schema=PATTERN do NOT dump the specified schema(s)-O, --no-owner               在明文格式中, 忽略恢复对象所属者-s, --schema-only            只转储模式, 不包括数据-S, --superuser=NAME         在明文格式中使用指定的超级用户名-t, --table=PATTERN          dump the specified table(s) only-T, --exclude-table=PATTERN  do NOT dump the specified table(s)-x, --no-privileges          不要转储权限 (grant/revoke)--binary-upgrade             只能由升级工具使用--column-inserts             以带有列名的INSERT命令形式转储数据--disable-dollar-quoting     取消美元 (符号) 引号, 使用 SQL 标准引号--disable-triggers           在只恢复数据的过程中禁用触发器--enable-row-security        启用行安全性（只转储用户能够访问的内容）--exclude-table-data=PATTERN do NOT dump data for the specified table(s)--extra-float-digits=NUM     覆盖extra_float_digits的默认设置--if-exists                  当删除对象时使用IF EXISTS--include-foreign-data=PATTERNinclude data of foreign tables on foreignservers matching PATTERN--inserts                    以INSERT命令，而不是COPY命令的形式转储数据--load-via-partition-root    通过根表加载分区--no-comments                不转储注释--no-publications            不转储发布--no-security-labels         不转储安全标签的分配--no-subscriptions           不转储订阅--no-synchronized-snapshots  在并行工作集中不使用同步快照--no-tablespaces             不转储表空间分配信息--no-unlogged-table-data     不转储没有日志的表数据--on-conflict-do-nothing     将ON CONFLICT DO NOTHING添加到INSERT命令--quote-all-identifiers      所有标识符加引号，即使不是关键字--rows-per-insert=NROWS      每个插入的行数；意味着--inserts--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 环境变量
的数值.Report bugs to <pgsql-bugs@lists.postgresql.org>.
PostgreSQL home page: <https://www.postgresql.org/>

二. pg_dumpall

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

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, --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           在只恢复数据的过程中禁用触发器--exclude-database=PATTERN   排除名称与PATTERN匹配的数据库--extra-float-digits=NUM     覆盖extra_float_digits的默认设置--if-exists                  当删除对象时使用IF EXISTS--inserts                    以INSERT命令，而不是COPY命令的形式转储数据--load-via-partition-root    通过根表加载分区--no-comments                不转储注释--no-publications            不转储发布--no-role-passwords          不转储角色的密码--no-security-labels         不转储安全标签的分配--no-subscriptions           不转储订阅--no-sync                    不用等待变化安全写入磁盘--no-tablespaces             不转储表空间分配信息--no-unlogged-table-data     不转储没有日志的表数据--on-conflict-do-nothing     将ON CONFLICT DO NOTHING添加到INSERT命令--quote-all-identifiers      所有标识符加引号，即使不是关键字--rows-per-insert=NROWS      每个插入的行数；意味着--inserts--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如果没有使用 -f/--file，那么将把SQL脚本写到标准输出.Report bugs to <pgsql-bugs@lists.postgresql.org>.
PostgreSQL home page: <https://www.postgresql.org/>

三. psql

psql --set ON_ERROR_STOP=on dbname < infile
不管怎样，你将只能得到一个部分恢复的数据库。作为另一种选择，你可以指定让整个恢复作为一个单独的事务运行，这样恢复要么完全完成要么完全回滚。这种模式可以通过向psql传递-1或–single-transaction命令行选项来指定。在使用这种模式时，注意即使是很小的一个错误也会导致运行了数小时的恢复被回滚。但是，这仍然比在一个部分恢复后手工清理复杂的数据库要更好。

psql是PostgreSQL 的交互式客户端工具。
使用方法:psql [选项]... [数据库名称 [用户名称]]
通用选项:-c, --command=命令       执行单一命令(SQL或内部指令)然后结束-d, --dbname=DBNAME      指定要连接的数据库 (默认："xingwai")-f, --file=文件名        从文件中执行命令然后退出-l, --list               列出所有可用的数据库,然后退出-v, --set=, --variable=NAME=VALUE设置psql变量NAME为VALUE(例如，-v ON_ERROR_STOP=1)-V, --version            输出版本信息, 然后退出-X, --no-psqlrc          不读取启动文档(~/.psqlrc)-1 ("one"), --single-transaction作为一个单一事务来执行命令文件(如果是非交互型的)-?, --help[=options]     显示此帮助，然后退出--help=commands      列出反斜线命令，然后退出--help=variables     列出特殊变量，然后退出输入和输出选项：-a, --echo-all           显示所有来自于脚本的输入-b, --echo-errors        回显失败的命令-e, --echo-queries       显示发送给服务器的命令-E, --echo-hidden        显示内部命令产生的查询-L, --log-file=文件名    将会话日志写入文件-n, --no-readline        禁用增强命令行编辑功能(readline)-o, --output=FILENAME    将查询结果写入文件(或 |管道)-q, --quiet              以沉默模式运行(不显示消息，只有查询结果)-s, --single-step        单步模式 (确认每个查询)-S, --single-line        单行模式 (一行就是一条 SQL 命令)输出格式选项 :-A, --no-align           使用非对齐表格输出模式--csv                CSV（逗号分隔值）表输出模式-F, --field-separator=STRING为字段设置分隔符,用于不整齐的输出(默认："|")-H, --html               HTML 表格输出模式-P, --pset=变量[=参数]   设置将变量打印到参数的选项(查阅 \pset 命令)-R, --record-separator=STRING为不整齐的输出设置字录的分隔符(默认：换行符号)-t, --tuples-only        只打印记录i-T, --table-attr=文本    设定 HTML 表格标记属性（例如,宽度,边界)-x, --expanded           打开扩展表格输出-z, --field-separator-zero为不整齐的输出设置字段分隔符为字节0-0, --record-separator-zero为不整齐的输出设置记录分隔符为字节0联接选项:-h, --host=主机名        数据库服务器主机或socket目录(默认："本地接口")-p, --port=端口          数据库服务器的端口(默认："5432")-U, --username=用户名    指定数据库用户名(默认："xingwai")-w, --no-password        永远不提示输入口令-W, --password           强制口令提示 (自动)

四. pg_restore

pg_restore 从一个归档中恢复一个由 pg_dump 创建的 PostgreSQL 数据库.用法:pg_restore [选项]... [文件名]一般选项:-d, --dbname=名字        连接数据库名字-f, --file=文件名       输出文件名(- 对于stdout)-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    不恢复此模式中的对象-O, --no-owner               不恢复对象所属者-P, --function=NAME(args)    恢复指定名字的函数-s, --schema-only            只恢复模式, 不包括数据-S, --superuser=NAME         使用指定的超级用户来禁用触发器-t, --table=NAME             恢复命名关系（表、视图等）-T, --trigger=NAME           恢复指定名字的触发器-x, --no-privileges          跳过处理权限的恢复 (grant/revoke)-1, --single-transaction     作为单个事务恢复--disable-triggers           在只恢复数据的过程中禁用触发器--enable-row-security        启用行安全性--if-exists                  当删除对象时使用IF EXISTS--no-comments                不恢复注释--no-data-for-failed-tables  对那些无法创建的表不进行数据恢复--no-publications            不恢复发行--no-security-labels         不恢复安全标签信息--no-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操作选项 -I, -n, -N, -P, -t, -T, 以及 --section 可以组合使用和指定
多次用于选择多个对象.如果没有提供输入文件名, 则使用标准输入.Report bugs to <pgsql-bugs@lists.postgresql.org>.
PostgreSQL home page: <https://www.postgresql.org/>

五.参考文章

PostgreSQL备份工具pg_dump和pg_dumpall

PPAS数据库备份与恢复

数据库PostrageSQL-备份和恢复

[PostgreSQL学习手册] (有用)

导出整个数据库
pg_dump  --dbname=postgres://用户名:'密码'@地址:端口(5432)/数据库 > /导出的地址/数据库名.sql"
导入整个数据库
psql --dbname=postgres://用户名:'密码'@地址:端口(5432)/数据库 < /导入的地址/数据库名.sql