PostgreSQL 文档检索
PG 18 · 按类别浏览,或输入名称与关键词
分类索引819
pg_dump --statistics--statistics
转储优化器统计信息。pg_dump › 选项
pg_dump --statistics-only--statistics-only
只转储统计信息,不转储模式(数据定义)或数据。会转储表、物化视图、外部表和索引的优化器统计信息。pg_dump › 选项
pg_dump --strict-names--strict-names
要求每个扩展(-e/--extension)、模式(-n/--schema)和表(-t/--table)模式在要转储的数据库中至少匹配一个扩展/模式/表。这也适用于配合 --filter 使用的过滤器。请注意,如果所有扩展/模式/表模式都找不到匹配项,那么 pg_dump 即使在不使用 --strict-names 的情况下也会报错。 此选项对 -…pg_dump › 选项
pg_dump --superuser=username-S username--superuser=username
指定在禁用触发器时要使用的超级用户名。这只在使用 --disable-triggers 时相关。(通常最好省略它,而是以超级用户身份运行生成的脚本。)pg_dump › 选项
pg_dump --sync-method=method--sync-method=method
当设为 fsync 时(这是默认值),pg_dump --format=directory 会递归打开并同步归档目录中的所有文件。 在 Linux 上,也可以改用 syncfs,让操作系统同步包含归档目录的整个文件系统。关于需要注意的问题,请参见recovery_init_sync_method中有关使用 syncfs 的信息。 当使用…pg_dump › 选项
pg_dump --table-and-children=pattern--table-and-children=pattern
这与 -t/--table 选项相同,只是它还会包含匹配 pattern 的表的任何分区或继承子表。pg_dump › 选项
pg_dump --table=pattern-t pattern--table=pattern
只转储名称匹配 pattern 的表。可以通过写多个 -t 开关来选择多个表。pattern 参数按照 psql 的 \d 命令所使用的同样规则进行解释(见模式),因此也可以通过在模式中使用通配符来选择多个表。使用通配符时,如有需要请小心为模式加引号,以防止 shell 展开通配符;见下文的示例。 除了表之外,此选项还可用于转…pg_dump › 选项
pg_dump --use-set-session-authorization--use-set-session-authorization
输出符合 SQL 标准的 SET SESSION AUTHORIZATION 命令,而不是 ALTER OWNER 命令来确定对象所有权。这会让转储更符合标准,但根据转储中对象的历史,可能无法正确恢复。另外,使用 SET SESSION AUTHORIZATION 的转储肯定需要超级用户权限才能正确恢复,而 ALT…pg_dump › 选项
pg_dump --username=username-U username--username=username
用于连接的用户名。pg_dump › 选项
pg_dump --verbose-v--verbose
指定详细模式。这会使 pg_dump 将详细的对象注释、开始/停止时间写入转储文件,并把进度消息写到标准错误。重复该选项会让更多调试级别消息出现在标准错误中。pg_dump › 选项
pg_dump --version-V--version
打印 pg_dump 的版本并退出。pg_dump › 选项
pg_dumpallpg_dumpall — 将一个 PostgreSQL 数据库集簇转储为脚本文件
客户端程序
pg_dumpall [ connection-option ...] [ option ...]
手册中的可执行程序 pg_dumpall
程序版本 10.23
参考清单 客户端程序
选项定义组 38
手册中的选项
只转储数据,不转储模式(数据定义)。 -a --data-only…命令行工具 · 客户端程序
pg_dumpall --attribute-inserts--column-inserts--attribute-inserts
将数据转储为带有显式列名的INSERT命令(INSERT INTO table (column, ...) VALUES ...)。这会使恢复变得非常缓慢;它主要用于生成可以装入非 PostgreSQL 数据库的转储。pg_dumpall › 选项
pg_dumpall --binary-upgrade--binary-upgrade
此选项供就地升级实用程序使用。不建议也不支持将其用于其他目的。该选项的行为可能在未来的版本中更改而不另行通知。pg_dumpall › 选项
pg_dumpall --clean-c--clean
在重新创建之前,输出用于DROP所有已转储数据库、角色和表空间的 SQL 命令。当恢复需要覆盖现有集簇时,此选项很有用。如果目标集簇中不存在某些对象,则恢复期间会报告可忽略的错误消息,除非还指定了--if-exists。pg_dumpall › 选项
pg_dumpall --data-only-a--data-only
只转储数据,不转储模式(数据定义)或统计信息。pg_dumpall › 选项
pg_dumpall --database=dbname-l dbname--database=dbname
指定用于转储全局对象并发现还应转储哪些数据库的连接数据库名。如果未指定,则使用postgres数据库;如果该数据库不存在,则使用template1。pg_dumpall › 选项
pg_dumpall --dbname=connstr-d connstr--dbname=connstr
以连接字符串形式指定用于连接服务器的参数;这些参数将覆盖任何冲突的命令行选项。 该选项名为--dbname,是为了与其他客户端应用程序保持一致;但由于pg_dumpall需要连接多个数据库,连接字符串中的数据库名将被忽略。请使用-l选项指定初始连接所用的数据库名,该连接将用于转储全局对象并发现还应转储哪些数据库。pg_dumpall › 选项
pg_dumpall --disable-dollar-quoting--disable-dollar-quoting
此选项禁用对函数体的美元引用,并强制用 SQL 标准字符串语法对它们加引号。pg_dumpall › 选项
pg_dumpall --disable-triggers--disable-triggers
此选项只在创建包含数据但不包含模式的转储时才相关。它指示pg_dumpall在输出中包含一些命令,以便在恢复数据时临时禁用目标表上的触发器。如果这些表上存在不希望在数据恢复期间触发的引用完整性检查或其他触发器,请使用此选项。 目前,为 --disable-triggers 输出的这些命令必须由超级用户执行。因此,还应通过 -S 指定一个超级…pg_dumpall › 选项
pg_dumpall --encoding=encoding-E encoding--encoding=encoding
在指定的字符集编码中创建转储。默认情况下,转储将以数据库编码创建。(获得相同结果的另一种方法是将PGCLIENTENCODING环境变量设置为所需的转储编码。)pg_dumpall › 选项
pg_dumpall --exclude-database=pattern--exclude-database=pattern
不转储名称匹配pattern的数据库。可以多次写--exclude-database开关,以排除匹配所给模式中任意一个的数据库。pattern参数按照psql的\d命令所使用的同样规则解释(见模式),因此也可以通过在模式中使用通配符来排除多个数据库。使用通配符时,如有需要请务必为模式加引号,以防止 shell 展开通配符。pg_dumpall › 选项
pg_dumpall --extra-float-digits=ndigits--extra-float-digits=ndigits
在转储浮点数据时,使用指定的 extra_float_digits 值,而不是最大可用精度。出于备份目的的常规转储不应使用此选项。pg_dumpall › 选项
pg_dumpall --file=filename-f filename--file=filename
将输出发送到指定文件。如果省略此选项,则使用标准输出。pg_dumpall › 选项
pg_dumpall --filter=filename--filter=filename
指定一个文件名,从中读取要从转储中排除的数据库名称的匹配模式。这些模式按照与--exclude-database相同的规则解释。要从STDIN读取,请使用-作为文件名。--filter可与--exclude-database结合使用以排除数据库,也可以指定多次以读取多个过滤文件。 该文件每行列出一个数据库名匹配模式,格式如下: exclude…pg_dumpall › 选项
pg_dumpall --globals-only-g--globals-only
只转储全局对象(角色和表空间),不转储数据库。pg_dumpall › 选项
pg_dumpall --help-?--help
显示关于pg_dumpall命令行参数的帮助信息,并退出。pg_dumpall › 选项
pg_dumpall --host=host-h host--host=host
指定运行数据库服务器的机器的主机名。如果该值以斜杠开头,则将其用作 Unix 域套接字的目录。默认值取自PGHOST环境变量(如果已设置);否则会尝试使用 Unix 域套接字连接。pg_dumpall › 选项
pg_dumpall --if-exists--if-exists
使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会抑制原本可能报告的“does not exist”错误信息。除非同时指定了 --clean,否则此选项无效。pg_dumpall › 选项
pg_dumpall --inserts--inserts
将数据转储为INSERT命令(而不是COPY)。这会使恢复非常缓慢;它主要用于生成可以装入非 PostgreSQL 数据库的转储。注意,如果重新安排了列顺序,恢复可能会彻底失败。--column-inserts选项可以避免列顺序变化带来的问题,但速度更慢。pg_dumpall › 选项
pg_dumpall --load-via-partition-root--load-via-partition-root
当为表分区转储数据时,让COPY或INSERT语句以包含该分区的分区层次结构根为目标,而不是以该分区本身为目标。这会导致在加载数据时为每一行重新确定适当的分区。当在另一台服务器上恢复数据,而行并不总是落在与原始服务器相同的分区中时,这可能很有用。例如,如果分区列是 text 类型,而两个系统对用于排序该分区列的排序规则定义不同…pg_dumpall › 选项
pg_dumpall --lock-wait-timeout=timeout--lock-wait-timeout=timeout
在转储开始时,不要无限等待获取共享表锁。如果无法在指定的timeout内锁定某个表,就让转储失败。超时可以用SET statement_timeout接受的任意格式指定。pg_dumpall › 选项
pg_dumpall --no-acl-x--no-privileges--no-acl
不转储访问权限(GRANT/REVOKE 命令)。pg_dumpall › 选项
pg_dumpall --no-comments--no-comments
不要转储COMMENT命令。pg_dumpall › 选项
pg_dumpall --no-data--no-data
不要转储数据。pg_dumpall › 选项
pg_dumpall --no-owner-O--no-owner
不要输出用于将对象所有权设置为与原始数据库一致的命令。默认情况下,pg_dumpall会发出ALTER OWNER或SET SESSION AUTHORIZATION语句,以设置已创建模式元素的所有权。除非该脚本由超级用户(或拥有脚本中全部对象的同一用户)启动,否则这些语句在运行时会失败。若要创建一个可由任意用户恢复、并让该用户获得所有对象所有权的脚本…pg_dumpall › 选项
pg_dumpall --no-password-w--no-password
绝不发出密码提示。如果服务器要求密码认证,而又无法通过 .pgpass 文件等其他方式获得密码,则连接尝试将失败。在没有用户在场输入密码的批处理作业和脚本中,此选项很有用。pg_dumpall › 选项
pg_dumpall --no-policies--no-policies
不要转储行安全性策略。pg_dumpall › 选项
pg_dumpall --no-publications--no-publications
不要转储发布。pg_dumpall › 选项
pg_dumpall --no-role-passwords--no-role-passwords
不要转储角色密码。恢复后,角色的密码值将为 null,在设置密码之前,密码认证始终会失败。由于指定此选项时不需要密码值,角色信息将从目录视图pg_roles而不是pg_authid读取。因此,如果某些安全策略限制了对pg_authid的访问,此选项也会有帮助。pg_dumpall › 选项
更多结果
输入名称或关键词,从 PostgreSQL 手册与扩展目录中直接找到定义。
pg17: 限定版本 ex: 只搜扩展 ↑↓ 选择 ↵ 打开