建立个人网站代码,做网站要固定ip,培训课程设计,河北优化网站获客qq目录
命令格式
连接选项 参数选项
使用举例 pg_dump是用于备份一种PostgreSQL数据库的工具。即使数据库正在被并发使用#xff0c;它也能创建一致的备份。pg_dump不阻塞其他用户访问数据库#xff08;读取或写入#xff09;。
pg_dump只备份单个数据库。要备份一个集簇…目录
命令格式
连接选项 参数选项
使用举例 pg_dump是用于备份一种PostgreSQL数据库的工具。即使数据库正在被并发使用它也能创建一致的备份。pg_dump不阻塞其他用户访问数据库读取或写入。
pg_dump只备份单个数据库。要备份一个集簇中 对于所有数据库公共的全局对象例如角色和表空间应使用pg_dumpall
转储可以被输出到脚本或归档文件格式。脚本转储是包含 SQL 命令的纯文本文件它们可以用来重构数据库到它被转储时的状态。要从这样一个脚本恢复将它喂给psql。脚本文件甚至可以被用来在其他机器和其他架构上重构数据库。在经过一些修改后甚至可以在其他 SQL 数据库产品上重构数据库。
另一种可选的归档文件格式必须与pg_restore配合使用来重建数据库。它们允许pg_restore能选择恢复什么或者甚至在恢复之前对条目重排序。归档文件格式被设计为在架构之间可移植。
当使用归档文件格式之一并与pg_restore组合时pg_dump提供了一种灵活的归档和传输机制。pg_dump可以被用来备份整个数据库然后pg_restore可以被用来检查归档并/或选择数据库的哪些部分要被恢复。最灵活的输出文件格式是“自定义”格式-Fc和“目录”格式-Fd。它们允许选择和重排序所有已归档项、支持并行恢复并且默认是压缩的。“目录”格式是唯一一种支持并行转储的格式。
命令格式
pg_dump [connection-option...] [option...] [dbname]
连接选项
长选项短选项含义--dbnamedbname-d dbname 指定要连接到的数据库名。这等效于指定dbname为命令行上的第一个非选项参数。 如果这个参数包含一个符号或者以一个合法的URI前缀postgresql://或postgres://开始它将被视作一个conninfo字符串。详见第 33.1 节。 --hosthost -h host指定服务器正在运行的机器的主机名。如果该值开始于一个斜线它被用作一个 Unix 域套接字的目录。默认是从PGHOST环境变量中取得如果被设置否则将尝试一次 Unix 域套接字连接。--portport-p port 指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。默认是放在PGPORT环境变量中如果被设置否则使用编译在程序中的默认值。 --usernameusername -U username 要作为哪个用户连接。 --no-password -w从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令例如一个.pgpass文件那么连接尝试将失败。这个选项对于批处理任务和脚本有用因为在其中没有一个用户来输入口令。 --password -W 强制pg_dump在连接到一个数据库之前提示要求一个口令。 这个选项从来不是必须的因为如果服务器要求口令认证pg_dump将自动提示要求一个口令。但是pg_dump将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得键入-W来避免额外的连接尝试。 --rolerolename 指定一个用来创建该转储的角色名。这个选项导致pg_dump在连接到数据库后发出一个SET ROLE rolename命令。当已认证用户由-U指定缺少pg_dump所需的特权但是能够切换到一个具有所需权利的角色时这个选项很有用。一些安装有针对直接作为超级用户登录的策略使用这个选项可以让转储在不违反该策略的前提下完成。 参数选项
长选项短选项含义dbname指定要被备份的数据库名。如果没有指定将使用环境变量PGDATABASE。如果环境变量也没有设置则使用指定给该连接的用户名。 --data-only -a 只备份数据而不备份模式数据定义。表数据、大对象和序列值都会被转储。 --blobs -b在转储中包括大对象。这是当--schema、--table或 --schema-only被指定时的默认行为因此-b 开关仅对于将大对象添加到已请求特定模式或表的转储中时有用。 请注意blob被视为数据因此仅在使用--data-only时才会包含 但在--schema-only时不会包含。 --no-blobs -B 排除转储中的大对象。 当给定-b和-B时行为是当数据被转储时输出大对象 请参阅-b文档。 --clean -c 在输出创建数据库对象的命令之前输出清除删除它们的命令 除非也指定了--if-exists如果任何对象不存在于 目的数据库中恢复可能会产生一些伤害性的错误消息。 这个选项只对纯文本格式有意义。对于归档格式你可以在调用pg_restore时指定该选项。 --create -C 使得在输出的开始是一个创建数据库本身并且重新连接到被创建的数据库的命令通过这种形式的一个脚本在运行脚本之前你连接的是目标安装中的哪个数据库都没有关系。如果也指定了--clean脚本会在重新连接到目标数据库之前先删除它然后再重建。 这个选项只对纯文本格式有意义。对于归档格式你可以在你调用pg_restore时指定这个选项。 --encodingencoding -E encoding 以指定的字符集编码创建备份。在默认情况下该备份会以该数据库的编码创建另一种得到相同结果的方式是将PGCLIENTENCODING环境变量设置成想要的转储编码。 --filefile -f file将输出发送到指定文件。对于基于输出格式的文件这个参数可以被忽略在那种情况下将使用标准输出。不过对于目录输出格式必须给定这个参数在目录输出格式中指定的是一个目录而不是一个文件。在这种情况中该目录会由pg_dump创建并且不需要以前就存在。 --formatformat -F format 选择输出的格式。format可以是下列之一 pplain 输出一个纯文本形式的SQL脚本文件默认值。 ccustom 输出一个适合于作为pg_restore输入的自定义格式归档。和目录输出格式一起这是最灵活的输出格式它允许在恢复时手动选择和排序已归档的项。这种格式在默认情况还会被压缩。 ddirectory 输出一个适合作为pg_restore输入的目录格式归档。这将创建一个目录其中每个被转储的表和大对象都有一个文件外加一个所谓的目录文件该文件以一种pg_restore能读取的机器可读格式描述被转储的对象。一个目录格式归档能用标准 Unix 工具操纵例如一个未压缩归档中的文件可以使用gzip工具压缩。这种格式默认情况下是被压缩的并且也支持并行转储。 ttar 输出一个适合于输入到pg_restore中的tar-格式归档。tar 格式可以兼容目录格式抽取一个 tar 格式的归档会产生一个合法的目录格式归档。不过tar 格式不支持压缩。还有在使用 tar 格式时表数据项的相对顺序不能在恢复过程中被更改。 --jobsnjobs -j njobs 通过同时归档njobs个表来运行并行转储。这个选项缩减了转储的时间但是它也增加了数据库服务器上的负载。你只能和目录输出格式一起使用这个选项因为这是唯一一种让多个进程能在同一时间写其数据的输出格式。 pg_dump将打开njobs 1 个到该数据库的连接因此确保你的max_connections设置足够高以容纳所有的连接。 在运行一次并行转储时请求数据库对象上的排他锁可能导致转储失败。其原因是pg_dump主控进程会在工作者进程将要稍后转储的对象上请求共享锁以便确保在转储运行时不会有人删除它们并让它们出错。如果另一个客户端接着请求一个表上的排他锁那个锁将不会被授予但是会被排入队列等待主控进程的共享锁被释放。因此任何其他对该表的访问将不会被授予或者将排在排他锁请求之后。这包括尝试转储该表的工作者进程。如果没有任何防范措施这可能会是一种经典的死锁情况。要检测这种冲突pg_dump工作者进程使用NOWAIT选项请求另一个共享锁。 如果该工作者进程没有被授予这个共享锁其他某人必定已经在同时请求了一个排他锁并且没有办法继续转储因此pg_dump除了中止转储之外别无选择。 对于一个一致的备份数据库服务器需要支持同步的快照在PostgreSQL 9.2中引入了一种针对主服务器特性和10个针对备用服务器的特性。有了这种特性即便数据库客户端使用不同的连接也可以保证他们看到相同的数据集。pg_dump -j使用多个数据库连接它用主控进程连接到数据一次并且为每一个工作者任务再一次连接数据库。如果没有同步快照特征在每一个连接中不同的工作者任务将不能被保证看到相同的数据这可能导致一个不一致的备份。 如果你希望运行一个 9.2 之前服务器的并行转储你需要确保数据库内容从主控进程连接到数据库一直到最后一个工作者任务连接到数据库之间不会改变。做这些最简单的方法是在开始备份之前停止任何访问数据库的数据修改进程DDL 以及 DML。当对一个 9.2 之前的PostgreSQL服务器运行pg_dump -j时你还需要指定--no-synchronized-snapshots参数。 --schemaschema -n schema 只转储匹配schema的模式这会选择模式本身以及它所包含的所有对象。当没有指定这个选项时目标数据库中所有非系统模式都将被转储。多个模式可以通过书写多个-n开关来选择。另外schema参数可以被解释为一种根据psqls \d命令所用的相同规则见模式Pattern编写的模式这样多个模式也可以通过在该模式中书写通配字符来选择。在使用通配符时如果需要阻止 shell 展开通配符需要小心引用该模式见实例。 --exclude-schemaschema -N schema 不转储匹配schema模式的任何模式。该模式被根据-n所用的相同规则被解释。-N可以被给定多次来排除匹配几个模式中任意一个的模式。 当-n和-N都被给定时该行为是只转储匹配至少一个-n开关但是不匹配-N开关的模式。如果只有-N而没有-n那么匹配-N的模式会被从一个正常转储中排除。 -o --oids -o 备份对象标识符OID作为每个表数据的一部分。如果你的应用以某种方式引用OID列例如在一个外键约束中应使用这个选项。否则这个选项不应该被使用。 --no-owner -O --no-reconnect -R这个选项已经废弃但是为了向后兼容仍然能被接受。 --schema-only -s 只转储对象定义模式而非数据。 这个选项是--data-only的逆选项。它和指定--sectionpre-data --sectionpost-data相似但是由于历史原因又不完全相同。 不要把这个选项和--schema选项混淆后者在“schema”的使用上有不同的含义。 要为数据库中表的一个子集排除表数据见--exclude-table-data。 --superuserusername -S username 指定要在禁用触发器时使用的超级用户的用户名。只有使用--disable-triggers时这个选项才相关通常最好省去这个选项而作为超级用户来启动结果脚本来取而代之。 --tabletable -t 只转储名字匹配table的表“table”还可以包括视图、物化视图、序列和外部表。通过写多个-t开关可以选择多个表。另外table参数可以被解释为一种根据psqls \d命令所用的相同规则见模式Pattern编写的模式这样多个表也可以通过在该模式中书写通配字符来选择。在使用通配符时如果需要阻止 shell 展开通配符需要小心引用该模式见实例。 当-t被使用时-n和-N开关不会有效果因为被-t选择的表将被转储而无视那些开关并且非表对象将不会被转储。 --exclude-tabletable -T 不转储匹配table模式的任何表。该模式被根据-t所用的相同规则被解释。-T可以被给定多次来排除匹配几个模式中任意一个的模式。 当-t和-T都被给定时该行为是只转储匹配至少一个-t开关但是不匹配-T开关的表。如果只有-T而没有-t那么匹配-T的表会被从一个正常转储中排除。 --verbose -v 指定冗长模式。这将导致pg_dump向标准错误输出详细的对象注释以及转储文件的开始/停止时间还有进度消息。 --version -V pg_dump版本并退出。 --no-privileges--no-acl-x防止转储访问特权授予/收回命令。--compress0..9-Z 0..9指定要使用的压缩级别。零意味着不压缩。对于自定义归档格式这会指定个体表数据段的压缩并且默认是进行中等级别的压缩。对于纯文本输出设置一个非零压缩级别会导致整个输出文件被压缩就好像它被gzip处理过一样但是默认是不压缩。tar 归档格式当前完全不支持压缩。 --binary-upgrade 这个选项用于就地升级功能。我们不推荐也不支持把它用于其他目的。这个选项在未来的发行中可能被改变而不做通知。 --column-inserts--attribute-inserts将数据转储为带有显式列名的INSERT命令INSERT INTO table (column, ...) VALUES ...。这将使得恢复过程非常慢这主要用于使转储能够被载入到非PostgreSQL数据库中。不过由于这个选项为每一行都产生一个单独的命令重载一行时的一个错误只会导致那一行被丢失而不是整个表内容丢失。 --disable-dollar-quoting 这个选项禁止在函数体中使用美元符号引用并且强制它们使用 SQL 标准字符串语法被引用。 --disable-triggers 只有在创建一个只转储数据的转储时这个选项才相关。它指示pg_dump包括在数据被重新载入时能够临时禁用目标表上的触发器的命令。如果你在表上有引用完整性检查或其他触发器并且你在数据重新载入期间不想调用它们请使用这个选项。 当前为--disable-triggers发出的命令必须作为超级用户来执行。因此你还应当使用-S指定一个超级用户名或者宁可作为一个超级用户启动结果脚本。 这个选项只对纯文本格式有意义。对于归档格式你可以在调用pg_restore时指定这个选项。 --enable-row-security 只有在转储具有行安全性的表的内容时这个选项才相关。默认情况下 pg_dump将把 row_security设置为 off 来确保从该表中转储 出所有的数据。如果用户不具有足够能绕过行安全性的特权那么会抛出 一个错误这个参数指示pg_dump将 row_security设置为 on允许用户只转储该表中 它们能够访问到的部分内容。 请注意如果您当前使用此选项则可能还需要以INSERT格式转储 因为还原期间的COPY FROM不支持行安全性。 --exclude-table-datatable 不转储匹配table模式的任何表中的数据。该模式根据-t的相同规则被解释。--exclude-table-data可以被给定多次来排除匹配多个模式的表。当你需要一个特定表的定义但不想要其中的数据时这个选项就有用了。 要排除数据库中所有表的数据见--schema-only。 --if-exists 时间条件性命令即增加一个IF EXISTS子句来清除数据库和其他对象。 只有同时指定了--clean时这个选项才可用。 --inserts 将数据转储为INSERT命令而不是COPY。这将使得恢复非常慢这主要用于使转储能够被载入到非PostgreSQL数据库中。不过由于这个选项为每一行都产生一个单独的命令重载一行时的一个错误只会导致那一行被丢失而不是整个表内容丢失。注意如果你已经重新安排了列序该恢复可能会一起失败。--column-inserts选项对于列序改变是安全的但是会更慢。 --lock-wait-timeouttimeout 在转储的开始从不等待共享表锁的获得。而是在指定的timeout内不能锁定一个表时失败。超时时长可以用SET statement_timeout接受的任何格式指定允许的格式根据你从其转出的服务器版本变化但是所有版本都接受一个整数表示的毫秒数。。 --no-publications 不转储发布。 --no-security-labels 不转储安全标签。 --no-subscriptions 不转储订阅。 --no-sync 默认情况下pg_dump将等待所有文件安全写入磁盘。 这个选项会导致pg_dump无需等待而返回这更快 但意味着后续的操作系统崩溃可能会导致转储损坏。通常 此选项对于测试非常有用但在从生产安装中转储数据时不应使用此选项。 --no-synchronized-snapshots 这个选项允许对 9.2 以前的服务器运行pg_dump -j详见-j参数的文档。 --no-tablespaces 不要输出选择表空间的命令。通过这个选项在恢复期间所有的对象都会被创建在任何作为默认的表空间中。 这个选项只对纯文本格式有意义。对于归档格式你可以在调用pg_restore时指定该选项。 --no-unlogged-table-data 不转储非日志记录表的内容。这个选项对于表定义模式是否被转储没有影响它只会限制转储表数据。当从一个后备服务器转储时在非日志记录表中的数据总是会被排除。 --quote-all-identifiers 强制引用所有标识符。当从PostgreSQL主版本与pg_dump不同的服务器上转储一个数据库时或者当输出准备载入到一个具有不同主版本的服务器时推荐使用这个选项。默认情况下pg_dump只对在其主版本中是被保留词的标识符加上引号。在转储其他版本服务器时这种默认行为有时会导致兼容性问题因为那些版本可能具有些许不同的被保留词集合。使用--quote-all-identifiers能阻止这种问题但代价是转储脚本更难阅读。 --sectionsectionname 只转储命名节。节的名称可以是pre-data、data或post-data。这个选项可以被指定多次来选择多个节。默认是转储所有节。 数据节包含真正的表数据、大对象内容和序列值。数据后项包括索引、触发器、规则和除了已验证检查约束之外的约束的定义。数据前项包括所有其他数据定义项。 --serializable-deferrable 为转储使用一个可序列化事务以保证所使用的快照与后来的数据库状态是一致的。但是这样做是在事务流中等待一个点在该点上不能存在异常这样就不会有转储失败或者导致其他事务带着serialization_failure回滚的风险。关于事务隔离和并发控制详见第 13 章。 对于一个只为灾难恢复存在的转储这个选项没什么益处。如果一个转储被用来在原始数据库持续被更新期间载入一份用于报表或其他只读负载的数据库拷贝时这个选项就有所帮助。如果没有这个选项转储可能会反映一个与最终提交事务的任何执行序列都不一致的状态。例如如果使用了批处理技术一个批处理在转储中可以显示为关闭而其中的所有项都不出现。 如果 pg_dump 被启动时没有读写事务在活动则这个选项没有什么不同。如果有读写事务在活动该转储的启动可能会被延迟一段不确定的时间。一旦开始运行有没有这个开关的表现是相同的。 --snapshotsnapshotname 在做一个数据库的转储时指定一个同步的快照详见 表 9.82。 在需要把转储和一个逻辑复制槽见第 48 章 或者一个并发会话同步时可以用上这个选项。 在并行转储的情况下将使用这个选项指定的快照名而不是取一个新快照。 --strict-names 要求每一个模式-n/--schema和表-t/--table限定符匹配要转储的数据库中至少一个模式/表。注意如果没有找到有这样的模式/表限定符匹配即便没有--strict-namespg_dump也将生成一个错误。 这个选项对-N/--exclude-schema、-T/--exclude-table或者--exclude-table-data没有效果。无法匹配任何对象的排除模式不会被当作错误。 --use-set-session-authorization 输出 SQL-标准的SET SESSION AUTHORIZATION命令取代ALTER OWNER命令来确定对象的所有关系。这让该转储更加兼容标准但是取决于该转储中对象的历史该转储可能无法正常恢复。而且一个使用SET SESSION AUTHORIZATION的转储将一定会要求超级用户特权来正确地恢复而ALTER OWNER要求更少的特权。--help-? 显示有关pg_dump命令行参数的帮助并退出。 使用举例
