工具参考

clusterdb [connection-option…​] [ --verbose | -v ] [ --table | -t table ] …​ [dbname]

clusterdb接受下列命令行参数：

聚簇所有数据库。

当不使用 -a/ --all 时，指定要被聚簇的数据库名称。 如果数据库名称未指定，则从环境变量 PGDATABASE 中读取数据库名称。 如果该环境变量也没有被设置，则使用为连接指定的用户名作数据库名。 dbname 可以是 connection string。 如果是这样，连接时的字符串参数将覆盖所有冲突的命令行选项。

回显clusterdb生成并发送给服务器的命令。

不显示进度消息。

只聚簇 table。可以通过写多个 -t 开关来聚簇多个表。

在处理期间打印详细信息。

打印clusterdb版本并退出。

显示关于clusterdb命令行参数的帮助并退出。clusterdb也接受下列命令行参数用于连接参数：

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。

要作为哪个用户连接。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制clusterdb在连接到一个数据库之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，clusterdb将自动提示要求一个口令。但是，clusterdb将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

当使用 -a / --all 时，指定要连接到的数据库名称来发现哪些其他数据库应该被聚簇。 如果没有指定，将使用 postgres 数据库。而如果它也不存在，将使用 template1。 这可以是 connection string。如果是这样，连接时的字符串参数将覆盖所有冲突的命令行选项。 另外，连接到其他数据库时，除了数据库名字本身其他的连接时字符串参数将被重新使用。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

在有困难时，可以在 CLUSTER 和 psql 中找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

要聚簇数据库 test：

要聚簇在数据库 xyzzy 中的一个表 foo：

createdb [connection-option…​] [option…​] [dbname [description]]

createdb接受下列命令行参数：

指定要被创建的数据库名。该名称必须在这个集簇中所有IvorySQL数据库中唯一。默认是创建一个与当前系统用户同名的数据库。

指定与新创建的数据库相关联的一段注释。

指定该数据库的默认表空间（这个名称被当做一个双引号引用的标识符处理）。

回显createdb生成并发送到服务器的命令。

指定要在这个数据库中使用的字符编码模式。

指定要在这个数据库中使用的区域。这等效于同时指定`--lc-collate`和`--lc-ctype`。

指定要在这个数据库中使用的 LC_COLLATE 设置。

指定要在这个数据库中使用的 LC_CTYPE 设置。

指定拥有这个新数据库的数据库用户（这个名称被当做一个双引号引用的标识符处理）。

指定用于创建这个数据库的模板数据库（这个名称被当做一个双引号引用的标识符处理）。

打印createdb版本并退出。

显示关于createdb命令行参数的帮助并退出。选项 -D、-l 、 -E 、 -O`和 `-T 对应于底层 SQL 命令 CREATE DATABASE的选项，关于这些选项的信息可见该命令的内容。

createdb也接受下列命令行参数用于连接参数：

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。 这可以是 connection string。如果是这样，连接时字符串参数将覆盖所有冲突的命令行选项。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。

要作为哪个用户连接。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制createdb在连接到一个数据库之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，createdb将自动提示要求一个口令。但是，createdb将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

指定要连接到来发现哪些其他数据库应该被聚簇的数据库名。如果没有指定，将使用 postgres 数据库。而如果它也不存在（或者如果它就是要创建新数据库的名称），将使用 template1。

如果被设置，就是要创建的数据库名，除非在命令行中覆盖。

默认连接参数。如果没有在命令行或 PGDATABASE 指定要创建的数据库名， PGUSER 也决定要创建的数据库名。

规定在诊断消息中是否使用颜色。 可能的值为 always，auto 和 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

在有困难时，可以在 CREATE DATABASE和 psql 中找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

要使用默认数据库服务器创建数据库 demo：

要在主机 eden、端口 5000 上使用 template0 模板数据库创建数据库 demo，这里是命令行命令和底层SQL命令：

createuser [connection-option…​] [option…​] [username]

createuser接受下列命令行参数：

指定要被创建的IvorySQL用户的名称。这个名称必须与这个IvorySQL安装中所有现存角色不同。

为该新用户设置一个最大连接数。默认值为不设任何限制。

新用户将被允许创建数据库。

新用户将不被允许创建数据库。这是默认值。

回显createuser生成并发送给服务器的命令。

此选项已过时，但为了实现向后兼容仍然接受。

指定一个角色，这个角色将立即加入其中成为其成员。 如果要把这个角色加入到多个角色中作为成员， 可以写多个 -g 开关。

新角色将自动继承把它作为成员的角色的特权。这是默认值。

新角色将不会自动继承把它作为成员的角色的特权。

如果在命令行没有指定用户名，提示要求用户名，并且在命令行没有指定选项 -d / -D、 -r / -R、 -s / `-S`时也提示。

新用户将被允许登入（即，该用户名能被用作初始会话用户标识符）。这是默认值。

新用户将不被允许登入（一个没有登录特权的角色仍然可以作为管理数据库权限的方式而存在）。

如果给定，createuser将发出一个提示要求新用户的口令。如果你没有计划使用口令认证，这就不是必须的。

新用户将被允许创建新的角色（即，这个用户将具有 CREATEROLE 特权）。

新用户将不被允许创建新角色。这是默认值。

新用户将成为一个超级用户。

新用户将不会成为一个超级用户。这是默认值。

打印createuser版本并退出。

新用户将具有 REPLICATION 特权，这在 CREATE ROLE 的文档中有更完整的描述。

新用户将不具有 REPLICATION 特权，这在 CREATE ROLE 的文档中有更完整的描述。

显示有关createuser命令行参数的帮助并退出。

createuser也接受下列命令行参数作为连接参数：

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。

要作为哪个用户连接（不是要创建的用户名）。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制createuser在连接到一个数据库之前提示要求一个口令（用来连接到服务器，而不是新用户的口令）。这个选项不是必不可少的，因为如果服务器要求口令认证，createuser将自动提示要求一个口令。但是，createuser将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always， auto 和 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

在有困难时，可以在 CREATE ROLE 和 psql 中找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

要在默认数据库服务器上创建一个用户 joe：

要在默认数据库服务器上创建一个用户 joe 并提示要求一些额外属性：

要使用在主机 eden、端口 5000 上的服务器创建同一个用户 joe，并带有显式指定的属性，看看下面的命令：

要创建用户 joe 为一个超级用户并且立刻分配一个口令：

在上面的例子中，在录入新口令时新口令并没有真正地被回显，但是为了清晰，我们特意把它列了出来。如你所见，该口令在被发送给客户端之前会被加密。

dropdb [connection-option…​] [option…​] dbname

dropdb接受下列命令行参数：

指定要被移除的数据库的名字。

回显dropdb生成并发送给服务器的命令。

在删除目标数据库之前，尝试终止与该数据库的所有现有连接。有关此选项的详细信息，请参见 DROP DATABASE。

在做任何破坏性的工作之前发出一个验证提示。

打印dropdb版本并退出。

如果数据库不存在也不抛出一个错误。在这种情况下会发出一个提示。

显示有关dropdb命令行参数的帮助并退出。

dropdb也接受下列命令行参数作为连接参数：

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作Unix域套接字的目录。

指定服务器正在监听连接的TCP端口或本地Unix域套接字文件扩展。

要作为哪个用户连接。

不发出口令提示。如果服务器要求口令认证并且没有可用的口令（例如一个 .pgpass 文件），那么连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制dropdb在连接到一个数据库之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，dropdb将自动提示要求一个口令。但是，dropdb将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

指定一个数据库的名称，将连接到这个数据库以便删除目标数据库。如果没有指定，将使用 postgres 数据库。而如果它也不存在（或者它就是正在被删除的目标数据库），将使用 template1。这个值可以是一个 连接字符串。 如果是这样，连接字符串参数将覆盖任何有冲突的命令行选项。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always、 auto 以及 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

在有困难时，可以在 DROP DATABASE 和 psql 中找找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

要在默认数据库服务器上毁掉数据库 demo：

要使用在主机 eden、端口5000上的服务器中毁掉数据库 demo，并带有验证和回显，看看下面的命令：

dropuser [connection-option…​] [option…​] [username]

dropuser接受下列命令行参数：

指定要移除的IvorySQL用户的名字。如果没有在命令行指定并且使用了 -i / -−interactive 选项，你将被提醒要求一个用户名。

回显dropuser生成并发送给服务器的命令。

在实际移除该用户之前提示要求确认，并且在没有在命令行指定用户名提示要求一个用户名。

打印dropuser版本并退出。

如果用户不存在时不要抛出一个错误。在这种情况下将发出一个提示。

显示有关dropuser命令行参数的帮助并退出。

dropuser也接受下列命令行参数作为连接参数：

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作Unix域套接字的目录。

指定服务器正在监听连接的TCP端口或本地Unix域套接字文件扩展。

要作为哪个用户连接。

不发出口令提示。如果服务器要求口令认证并且没有可用的口令（例如一个 .pgpass 文件），那么连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制dropuser在连接到一个数据库之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，dropuser将自动提示要求一个口令。但是，dropuser将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always、 auto 以及 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

在有困难时，可以在 DROP ROLE 和 psql 中找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

要从默认数据库服务器移除用户 joe：

要使用在主机 eden、端口5000上的服务器移除用户 joe，并带有验证和回显，可使用下面的命令：

ecpg [option…​] file…​

自动从 SQL 代码生成确定的 C 代码。当前，这对 EXEC SQL TYPE 起效。

设置一个兼容性模式。mode 可以是 INFORMIX，INFORMIX_SE 或 ORACLE。

定义一个 C 预处理器符号。

处理头文件。指定此选项后，输出文件扩展名变为 .h 而不是 .c，默认输入文件扩展名为 .pgh 而不是 .pgc。此外，将强制启用 -c 选项。

分析系统也包括文件。

指定一个额外的包括路径，用来寻找通过 EXEC SQL INCLUDE 包括的文件。默认值是 . （当前目录）、 /usr/local/include 、在编译时定义的IvorySQL包括目录（默认： /usr/local/pgsql/include ）以及 /usr/include。

指定 ecpg 应该将它的所有输出写到给定的 filename。 写 -o- 将所有输出发送到标准输出。

选择运行时行为。option 可以是下列之一： no_indicator 不使用指示器而使用特殊值来表示空值。历史上曾有数据库使用这种方法。prepare 在使用所有语句之前准备它们。libecpg 将保持一个预备语句的缓冲并当语句再被执行时重用该语句。如果缓冲满了，libecpg 将释放最少使用的语句。`questionmarks`为兼容性原因允许使用问号作为占位符。在很久以前这被用作默认值。

打开事务的自动提交。在这种模式下，每一个 SQL 命令会被自动提交，除非它位于一个显式事务块中。在默认模式中，命令只有当 EXEC SQL COMMIT 被发出时才被提交。

打印额外信息，包括版本和“包括”路径。

打印ecpg版本并退出。

显示关于ecpg命令行参数的帮助并退出。

在编译预处理好的 C 代码文件时，编译器需要能够找到IvorySQL包括目录中的ECPG头文件。因此，在调用编译器时，你可能必须使用 -I 选项（例如， -I/usr/local/pgsql/include ）。

使用带有嵌入式 SQL 的 C 代码的程序必须被链接到 libecpg 库，例如使用链接器选项 -L/usr/local/pgsql/lib -lecpg。

适合于安装的这些目录的值可以使用 pg_config 找到。

如果你有一个名为 prog1.pgc 的嵌入式 SQL C 源文件，你可以使用下列命令序列创建一个可执行程序：

pg_amcheck [option…​] [dbname]

以下命令行选项控制要检查的内容：

检查所有数据库，但通过`--exclude-database`排除的数据库除外。

检查与指定的 pattern匹配的数据库，但`--exclude-database`排除的数据库除外。可以多次指定此选项。

排除与给定的 pattern匹配的数据库。可以多次指定此选项。

检查与指定的 pattern匹配的索引，除非它们被排除在外。可以多次指定此选项。这类似于 --relation 选项，只是它只适用于索引，而不适用于表。

排除与指定的 pattern匹配的索引。可以多次指定此选项。这类似于 --exclude-relation 选项，只是它只适用于索引，而不适用于表。

检查与指定的 pattern匹配的关系，除非它们被排除在外。可以多次指定此选项。模式可能是非限定的，例如 myrel*，或者它们可能是模式限定的，如 myschema*.myrel* 或数据库限定和模式限定，例如 mydb*.myscheam*.myrel*。数据库限定模式将向要检查的数据库列表中添加匹配的数据库。

排除与指定的 pattern匹配的关系。可以多次指定此选项。As with --relation, the pattern may be unqualified, schema-qualified, or database- and schema-qualified. 与 --relation`一样， `pattern可以是非限定的、模式限定的或数据库和模式限定的。

检查模式中与指定的 pattern匹配的表和索引，除非另有排除。可以多次指定此选项。要仅选择与特定模式匹配的模式中的表，请考虑使用类似 --table=SCHEMAPAT.* --no-dependent-indexes。要仅选择索引，请考虑使用类似 --index=SCHEMAPAT. 的方法。模式模式可以是数据库限定的。例如，你可以编写 --schema=mydb.myschema* 在数据库中选择匹配 mydb* 的模式。

排除模式中与指定的 pattern匹配的表和索引。可以多次指定此选项。与`--schema`一样，模式可以是数据库限定的。

检查与指定的 pattern匹配的表，除非它们被排除在外。可以多次指定此选项。这类似于`--relation`选项，只是它只适用于表，而不适用于索引。

排除与指定的 pattern 匹配的表。可以多次指定此选项。这类似于 --exclude-relation 选项，只是它只适用于表，而不适用于索引。

默认情况下，如果选中了一个表，则该表的任何btree索引也将被选中，即使它们没有被诸如 --index 或 --relation 之类的选项显式选择。此选项将抑制该行为。

默认情况下，如果选中了一个表，则也将检查它的toast表（如果有），即使它没有通过诸如 --table 或 --relation 之类的选项显式选择。此选项将抑制该行为。

默认情况下，如果 --database， --table， --index，或 --relation 的参数不匹配任何对象，则这是一个致命错误。此选项将该错误降级为警告。

以下命令行选项用于控制表的检查：

默认情况下，每当在表中遇到toast指针时，都会执行查找以确保它引用toast表中明显有效的条目。这些检查可能非常慢，可以使用此选项跳过这些检查。

在发现损坏的表的第一页上报告所有损坏后，停止处理该表关系，并转到下一个表或索引。请注意，索引检查总是在第一个损坏页之后停止。此选项仅与表关系相关。

如果给定 all-frozen，表损坏检查将跳过所有表中标记为全部冻结的页面。如果给定了 all-visible，则表损坏检查将跳过所有表中标记为所有可见的页面。默认情况下，不跳过任何页面。这可以指定为 none，但由于这是默认值，因此无需提及。

从指定的块号开始检查。如果正在检查的表关系的块数少于此数，则会发生错误。此选项不适用于索引，可能仅在检查单个表关系时有用。请参阅 --endblock 了解更多注意事项。

在指定的块号结束检查。如果正在检查的表关系的块数少于此数，则会发生错误。此选项不适用于索引，可能仅在检查单个表关系时有用。如果同时选中常规表和toast表，则此选项将同时适用于这两个表，但在验证toast指针时，仍然可以访问编号更高的toast块，除非使用 --exclude-toast-pointers 抑制。

以下命令行选项用来控制B树索引的检查：

对于每个选中的索引，使用 amcheck's heapallindexed 选项验证索引中是否存在作为索引元组的所有堆元组。

对于检查的每个btree索引，使用 amcheck 的 bt_index_parent_check 函数，该函数在索引检查期间对父/子关系执行其他检查。默认情况是使用amcheck的 bt_index_check 函数，但请注意，使用 --rootdescend 选项会隐式选择 bt_index_parent_check。

对于每个选中的索引，通过使用 amcheck's rootdescend 选项从根页面对每个元组执行新搜索，在叶级重新查找元组。使用此选项也会隐式选择 --parent-check 选项。这种形式的验证最初是为了帮助开发btree索引功能而编写的。它在帮助检测实践中发生的损坏类型方面可能用处有限，甚至毫无用处。它还可能导致损坏检查花费相当长的时间，并消耗服务器上相当多的资源。

当指定 --parent-check 选项或 --rootdescend 选项时，对B树索引执行的额外检查需要相对强的关系级锁。这些检查是唯一会阻止 INSERT， UPDATE，和 DELETE 命令并发数据修改的检查。

以下命令行选项用来控制与服务器的连接：

指定运行服务器的计算机的主机名。如果该值以斜杠开头，它将用作Unix域套接字的目录。

指定服务器正在侦听连接的TCP端口或本地Unix域套接字文件扩展名。

连接的用户名。

永远不要发出密码提示。如果服务器需要密码身份验证，并且密码无法通过其他方式（如 .pgpass 文件，连接尝试将失败。在没有用户输入密码的批处理作业和脚本中，此选项非常有用。

在连接到数据库之前，强制pg_amcheck提示输入密码。此选项从来都不是必需的，因为如果服务器要求密码身份验证，pg_amcheck将自动提示输入密码。但是，pg_amcheck将浪费一次连接尝试，以发现服务器需要密码。在某些情况下，键入 -W 以避免额外的连接尝试是值得的。

指定用于发现要检查的数据库列表的数据库或 连接字符串。如果既不使用 --all 也不使用任何包含数据库模式的选项，则不需要这种连接，并且该选项不起任何作用。否则，连接到正在检查的数据库时，也将使用此选项值中包含的数据库名称以外的任何连接字符串参数。如果省略此选项，则默认值为 postgres，或如果失败，则为 template1。

其它允许的选项：

回显发送到服务器的所有SQL。

使用 num 个到服务器的并发连接，或每个要检查的对象使用一个连接，以较小者为准。默认情况是使用单个连接。

显示进度信息。进度信息包括已完成检查的关系数以及这些关系的总大小。它还包括最终要检查的关系的总数，以及这些关系的估计大小。

打印更多消息。特别是，这将为每个正在检查的关系打印一条消息，并将增加服务器错误的详细程度。

打印pg_amcheck版本并退出。

安装检查数据库所需的任何缺少的扩展。如果尚未安装，每个扩展的对象将安装到给定的 schema 中，或者如果未指定则安装到 pg_catalog 模式中。目前，唯一需要的扩展是 amcheck。

显示有关pg_amcheck命令行参数的帮助，然后退出。

pg_basebackup [option…​]

下列命令行选项控制输出的位置和格式：

设置目标目录以将输出写入。如果该目录不存在，pg_basebackup将创建该目录（以及所有丢失的父目录）。如果已经存在，则必须为空。当备份处于 tar 模式中，目标目录可以被指定为 - （破折号），从而将 tar 文件写入 stdout。这个选项是必需的。

为输出选择格式。format 可以是下列之一： p plain 把输出写成平面文件，使用和源服务器数据目录和表空间相同的布局。 当集簇没有额外表空间时，整个数据库将被放在目标目录中。 如果集簇包含额外的表空间，主数据目录将被放置在目标目录中，但是所有其他表空间将被放在它们位于源服务器上的相同的绝对路径中。 (参见 --tablespace-mapping 来更改。)这是默认格式。t tar 将输出作为tar文件写入目标目录中。 主数据目录的内容将被写入名为 base.tar 的文件，而其他表空间将被写入以该表空间的OID命名的单独的tar文件。如果将目标目录指定为 -（破折号），则tar内容将被写入标准输出，该标准输出适用于管道传输至gzip（例如）。 只有当集簇没有额外表空间并且没有使用WAL流时才允许这样做。

创建一个 standby.signal 文件，并将连接设置附加到目标目录（或使用tar格式的基本存档文件中）的 postgresql.auto.conf 文件中。 这样可以简化使用备份结果设置备用服务器的过程。 postgresql.auto.conf 文件将记录连接设置（如果有）以及pg_basebackup所使用的复制槽，这样流复制后面就会使用相同的设置。

在备份期间将目录 olddir 中的表空间重定位到 newdir 中。为使之有效，olddir 必须与源服务器上定义的表空间的路径规范完全匹配。（但如果备份中没有包含 olddir 中的表空间也不是错误）。同时，newdir 是接收主机文件系统中的目录。与主目标目录一样，newdir 不必已经存在，但是如果确实存在，则必须为空。olddir 和 newdir 必须是绝对路径。如果一个路径凑巧包含了一个 = 符号，可用反斜线对它转义。对于多个表空间可以多次使用这个选项。如果以这种方法重定位一个表空间，主数据目录中的符号链接会被更新成指向新位置。因此新数据目录已经可以被一个所有表空间位于更新后位置的新服务器实例使用。目前，这个选项仅以普通输出格式工作，如果选择了tar格式，请忽略它。

指定用于预写式日志目录的位置。waldir 必须是绝对路径。只有当备份是平面文件模式时才能指定事务日志目录。 设置要写入WAL（预写日志）文件的目录。 默认情况下，WAL文件将放置在目标目录的 pg_wal 子目录中，但是此选项可用于将它们放置在其他位置。waldir 必须是绝对路径。与主目标目录一样，waldir 不必已经存在，但是如果确实存在，则必须为空。只有当备份是平面文件模式时才可以指定此选项。

在备份中包括所需的WAL（预写式日志）文件。这包括所有在备份期间产生的预写式日志。除非指定了方法 none，可以在目标目录中启动postmaster而无需参考日志归档，从而使输出成为完全独立的备份。支持下列收集预写式日志的 方法：n none 不要在备份中包括预写式日志。f fetch 在备份末尾收集预写式日志文件。因此，有必要把源服务器的 wal_keep_size 参数设置得足够高，这样在备份末尾之前需要的日志数据不会被移除。如果所需的日志数据在传输之前已被回收，则备份将失败并且无法使用。如果使用tar格式，预写式日志文件将被包含在 base.tar 文件。s stream 在进行备份时，流式传输预写式日志数据。将开启一个到服务器的第二连接并且在运行备份时并行开始流传输预写式日志。因此，它将需要两个复制连接，而不仅仅是一个。 只要客户端可以跟上预写式日志数据，使用此方法就不需要在源服务器上保存额外的预写式日志。如果使用tar格式，预写式日志文件被写入到一个单独的名为 pg_wal.tar 的文件（如果服务器的版本超过10，该文件将被命名为 pg_xlog.tar ）。这个值是默认值。

启用对 tar 文件输出的 gzip 压缩，使用默认的压缩级别。只有使用 tar 格式时压缩才可用，并且会在所有tar文件名后面自动加上后缀 .gz。

启用对 tar 文件输出的 gzip 压缩，并且制定压缩机别（0 到 9，0 是不压缩，9 是最佳压缩）。只有使用 tar 格式时压缩才可用，并且会在所有tar文件名后面自动加上后缀 .gz。

下列命令行选项控制备份的生成和程序的调用：

将检查点模式设置为 fast（立刻）或 spread（默认）。

指定在启动备份之前应创建由 --slot 选项命名的复制插槽。如果插槽已存在，则会引发错误。

为备份设置标签。如果没有指定，将使用一个默认值“ pg_basebackup base backup ”。

默认情况下，当 pg_basebackup 因为一个错误而中止时，它会把它意识到无法完成该工作之前已经创建的目录（例如目标目录和预写式日志目录）都移除。这个选项可以禁止这种清洗，因此可以用于调试。注意不管哪一种方式都不会清除表空间目录。

默认情况下，pg_basebackup 将等待所有文件被安全地写到磁盘上。这个选项导致 pg_basebackup 不做这种等待就返回，这样会更快一些，但是也意味着后续发生的操作系统崩溃可能会使得这个基础备份损坏。通常这个选项对测试比较有用，在创建生产安装时不应该使用。

启用进度报告。启用这个选项将在备份期间发表一个大致的进度报告。由于数据库可能在备份期间改变，这仅仅是一种近似并且可能不会刚好在 100% 结束。特别地，当 WAL 日志被包括在备份中时，总数据量无法预先估计，并且在这种情况中估计的目标尺寸会在它经过不带 WAL 的总估计后增加。

设置从源服务器收集数据的最大传输速率。这有助于限制pg_basebackup对服务器的影响。值以每秒千字节为单位。使用后缀 M 表示每秒兆字节数。后缀 k 也可以接受，没有任何影响。有效值介于每秒32千字节和每秒1024兆字节之间。此选项始终影响数据目录的传输。只有收集方法为 fetch 时，才会影响WAL文件的传输。

这个选项仅能与 -X stream 一起使用。它导致WAL流使用指定的复制槽。如果该基础备份的目的是被用作一台使用复制槽的流复制后备，则它应该使用与 primary_slot_name 中相同的复制槽名称。这可以确保主服务器不会移除位于该基础备份结束与新备用数据库上流复制开始之间产生的任何所需的WAL数据。指定的复制槽必须已经存在，除非同时使用了选项 -C。如果这个选项没有被指定并且服务器支持临时复制槽（版本10以后），则会自动使用一个临时复制槽来进行WAL流。

启用冗长模式。将在启动和关闭期间输出一些额外步骤，并且如果进度报告也被启用，还会显示当前正在被处理的确切文件名。

指定应应用于备份清单中包含的每个文件的校验和算法。目前，可用的算法有 NONE、 CRC32C、 SHA224、 SHA256、 SHA384 和 SHA512。默认值为 CRC32C。如果选择了 NONE，备份清单将不包含任何校验和。否则，它将包含备份中使用指定算法的每个文件的校验和。此外，清单将始终包含自身内容的 SHA256 校验和。SHA 算法比 CRC32C 算法占用大量CPU，因此选择其中一种算法可能会增加完成备份所需的时间。使用SHA散列函数可为希望验证备份是否遭到篡改的用户提供每个文件的加密安全摘要，而CRC32C算法提供的校验和计算速度更快。它擅长捕获由于意外更改引起的错误，但不能抵抗恶意修改。 请注意，为了对有权访问备份的对手有用，备份清单必须安全地存储在其他位置，否则必须经过验证以确保自从进行备份以来未进行任何修改。 pg_verifybackup 可用于根据备份清单检查备份的完整性。

强制备份清单中的所有文件名采用十六进制编码。如果未指定此选项，则仅对非UTF8文件名进行十六进制编码。此选项主要用于测试读取备份清单文件的工具是否正确处理此情况。

阻止服务器估计将要流式传输的备份数据总量，从而导致 pg_stat_progress_basebackup 视图中的 backup_total 列始终为 NULL 。如果没有此选项，则备份将从枚举整个数据库的大小开始，然后返回并发送实际内容。这可能会使备份花费的时间稍长一些，特别是在发送第一个数据之前，备份将花费更长的时间。 如果估计时间过长，此选项将有助于避免此类估计时间。使用 --progress 时不允许使用此选项。

禁用备份清单的生成。如果未指定此选项，则服务器将生成并发送备份清单，可以使用 pg_verifybackup 进行验证。清单是备份中存在的每个文件的列表，可能包含的所有WAL文件除外。它还存储大小、上次修改时间和每个文件的可选校验和。

防止为备份创建临时复制插槽。默认情况下，如果选择了日志流，但没有用选项 -S 指定槽名称，则会创建一个临时复制插槽（如果源服务器支持）。这个选项的主要目的是允许在服务器没有空闲复制槽可用时制作基础备份。使用复制槽几乎总是最好的方式，因为它能防止备份期间所需的WAL被删除。

如果在取基础备份的服务器上启用了校验码验证，则禁用校验码验证。默认情况下，校验码会被验证并且校验码失败将会导致一种非零的退出状态。不过，基础备份在这种情况下将不会被移除，就好像使用了 --no-clean 选项一样。校验和验证失败也将报告在 pg_stat_database 视图中。

以下命令行选项控制到源服务器的连接：

指定用于连接到服务器的参数，比如 连接字符串；这些将覆盖所有冲突的命令行选项。为了和其他客户端应用一致，该选项被称为 --dbname。但是因为pg_basebackup并不连接到集簇中的任何特定数据库，连接字符串中的任何数据库名将被忽略。

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量（如果设置），否则会尝试一个 Unix 域套接字连接。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。默认用 PGPORT 环境变量中的值（如果设置），或者一个编译在程序中的默认值。

指定发送回源服务器的状态包之间的秒数。较小的值可以更准确地监视服务器的备份进度。一个零值完全禁用这种周期性的状态更新，不过当服务器需要时还是会有一个更新会被发送来避免超时导致的断开连接。默认值是 10 秒。

指定连接的用户名。

防止发出口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制pg_basebackup在连接到源服务器之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，pg_basebackup将自动提示要求一个口令。但是，pg_basebackup将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

其他选项也可用：

打印pg_basebackup版本并退出。

显示有关pg_basebackup命令行参数的帮助并退出。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

环境变量 PG_COLOR 规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

在备份的开始时，需要在源服务器上执行检查点。这可能需要一点时间（尤其在没有使用选项 --checkpoint=fast 时），在此期间pg_basebackup看起来处于闲置状态。

备份将包括数据目录和表空间中的所有文件，包括配置文件以及由第三方放在该目录中的任何额外文件，不过由IvorySQL管理的特定临时文件除外。但只有常规文件和目录会被拷贝，但用于表空间的符号链接会被保留。指向IvorySQL已知的特定目录的符号链接被拷贝为空目录。其他符号链接和特殊设备文件会被跳过。

在普通格式中，表空间将备份到源服务器上的相同路径，除非使用了 --tablespace-mapping 选项。如果没有这个选项并且表空间正在使用，在同一台服务器上进行普通格式的基础备份将无法工作，因为备份必须要写入到与原始表空间相同的目录位置。

在使用 tar 格式时，用户应负责在启动使用数据的 IvorySQL 服务器前解压每一个 tar 文件。如果有额外的表空间，用于它们的 tar 文件需要被解压到正确的位置。在这种情况下，服务器将根据包含在 base.tar 文件中的 tablespace_map 文件的内容为那些表空间创建符号链接。

pg_basebackup可以和具有相同或较低主版本的服务器一起工作.

如果在源集簇上启用了组权限，pg_basebackup将保留数据文件的组权限。

要创建服务器 mydbserver 的一个基础备份并将它存储在本地目录 /usr/local/pgsql/data 中：

要创建本地服务器的一个备份，为其中每一个表空间产生一个压缩过的 tar 文件，并且将它存储在目录 backup 中，在运行期间显示一个进度报告：

要创建一个单一表空间本地数据库的备份并且使用bzip2压缩它：

（如果在该数据库中有多个表空间，这个命令将失败）。

要创建一个本地数据库的备份，其中 /opt/ts 中的表空间被重定位到 ./backup/ts：

pgbench -i [option…​] [dbname]

pgbench [option…​] [dbname]

pgbench -i 会创建四个表 pgbench_accounts、 pgbench_branches、 pgbench_history 以及 pgbench_tellers，如果同名表已经存在会被先删除。如果你已经有同名表，一定注意要使用另一个数据库！

在默认的情况下“比例因子”为 1，这些表初始包含的行数为：

你可以使用 -s （比例因子）选项增加行的数量。-F （填充因子）选项也可以在这里使用。

一旦你完成了必要的设置，你就可以用不包括 -i 的命令运行基准，也就是：

在近乎所有的情况中，你将需要一些选项来做一次有用的测试。最重要的选项是 -c （客户端数量）、 -t （事务数量）、-T （时间限制）以及 -f （指定一个自定义脚本文件）。完整的列表见下文。

下面分成三个部分。数据库初始化期间使用的选项和运行基准时会使用不同的选项，但也有一些选项在两种情况下都使用。

pgbench接受下列命令行初始化参数：

指定要测试的数据库的名称。 如果这个没有被指定，将使用环境变量 PGDATABASE 。 如果那个也没有设定，将使用指定要连接的用户名称。

要求调用初始化模式。

只执行选出的一组普通初始化步骤。init_steps 指定要被执行的初始化步骤，每一个步骤使用一个字符代表。每一个步骤都以指定的顺序被调用。默认是 dtgvp。可用的步骤是：d （删除）删除任何已有的pgbench表。t （创建表）创建标准pgbench场景使用的表，即 pgbench_accounts、 pgbench_branches、 pgbench_history 以及 pgbench_tellers。 g 或 G（生成数据、客户端或服务器端）生成数据并且装入到标准的表中，替换掉已经存在的任何数据。使用 g （客户端数据生成），数据在 pgbench 客户端生成，然后发送到服务器。 这通过 COPY 广泛使用客户端/服务器带宽。 使用 g 会导致日志记录每 100,000 行打印一条消息，同时为 pgbench_accounts 表生成数据。使用 G（服务器端数据生成），仅从 pgbench 客户端发送少量查询，然后在服务器中实际生成数据。 此变体不需要大量带宽，但服务器将完成更多工作。 使用 G 会导致日志记录在生成数据时不打印任何进度消息。默认的初始化行为使用客户端数据生成（相当于 g ）。 v （清理）在标准的表上调用 VACUUM 。 p （创建主键）在标准的表上创建主键索引。f （创建外键）在标准的表之间创建外键约束（注意这一步默认不会被执行）。

用给定的填充因子创建表 pgbench_accounts、 pgbench_tellers 以及 pgbench_branches。默认是100。

在初始化期间不执行清理（这个选项会抑制 v 初始化步骤，即便在 -I 中指定了该步骤）。

把记录切换到安静模式，只是每 5 秒产生一个进度消息。默认的记录会每 100,000 行打印一个消息，这经常会在每秒钟输出很多行（特别是在好的硬件上）。如果在 -I 中指定了 G，则此设置无效。

将生成的行数乘以比例因子。例如，-s 100 将在 pgbench_accounts 表中创建 10,000,000 行。默认为 1。当比例为 20,000 或更高时，用来保存账号标识符的列（ aid 列）将切换到使用更大的整数（ bigint ），这样才能足以保存账号标识符。

在标准的表之间创建外键约束（如果 f 在初始化步骤序列中不存在，这个选项会把它加入）。

在指定的表空间而不是默认表空间中创建索引。

使用 NAME 方法创建一个分区的 pgbench_accounts 表。 预期值为 range 或 hash。 此选项要求 --partitions 设置为非零。 如果未指定，默认值为 range。

创建一个分区 pgbench_accounts 表，其中 NUM 分区的大小与按比例缩放的帐户数几乎相等。 默认为 0，表示没有分区。

在指定的表空间而不是默认表空间中创建表。

把所有的表创建为非日志记录表而不是永久表。

pgbench接受下列命令行基准参数：

把指定的内建脚本加入到要被执行的脚本列表中。 可用的内建脚本有： tpcb-like、 simple-update 和 select-only 。 这里也接受内建名称无歧义的前缀缩写。 如果用上特殊的名字 list，将会显示内建脚本的列表并且立刻退出。可选的，在 @ 后面写一个整数权重以调整选择这个脚本而不是其它的概率。 默认的权重为1。 详情如下。

模拟的客户端数量，也就是并发数据库会话数量。默认为 1。

为每一个事务建立一个新连接，而不是只为每个客户端会话建立一个连接。这对于度量连接开销有用。

打印调试输出。

定义一个由自定义脚本（见下文）使用的变量。允许多个 -D 选项。

把一个从 filename 读到的事务脚本加入到被执行的脚本列表中。可选的，在 @ 后写一个整数权重以调整选择这个脚本而非其他的概率。 默认权重为1. (要使用包含 @ 字符的脚本文件名，附加权重在后面以避免歧义，例如 filen@me@1 。) 详情如下。

pgbench中的工作者线程数量。在多 CPU 机器上使用多于一个线程会有用。客户端会尽可能均匀地分布到可用的线程上。默认为 1。

把与每一个事务相关的信息写到一个日志文件中。详见下文。

对持续超过 limit 毫秒的事务进行独立的计数和报告， 这些事务被认为是 迟到（late） 了的事务。在使用限流措施时（ --rate=…​ ），滞后于计划超过 limit 毫秒并且因此没有希望满足延迟限制的事务根本 不会被发送给服务器。这些事务被认为是 被跳过（skipped） 的事务，它们会被单独计数并且报告。

要用来提交查询到服务器的协议： simple ：使用简单查询协议。 extended 使用扩展查询协议。 prepared ：使用带预备语句的扩展查询语句。在 prepared 模式中，pgbench重用从第二次查询迭代开始的语法分析结果，因此pgbench运行速度比其他模式快。默认是简单查询协议。

在运行测试前不进行清理。如果你在运行一个不包括标准的表 pgbench_accounts 、 pgbench_branches 、 pgbench_history 和 pgbench_tellers 的自定义测试场景时，这个选项是必需的。

运行内建的简单更新脚本。这是 -b simple-update 的简写。

每 sec 秒显示进度报告。该报告包括运行了多长时间、从上次报告以来的 tps 以及从上次报告以来事务延迟的平均值和标准偏差。如果低于限流值（ -R ），延迟会相对于事务预定的开始时间（而不是实际的事务开始时间）计算，因此其中也包括了平均调度延迟时间。

在基准结束后，报告平均的每个命令的每语句等待时间（从客户端的角度来说是执行时间）。详见下文。

按照指定的速率执行事务而不是尽可能快地执行（默认行为）。该速率 以 tps（每秒事务数）形式给定。如果目标速率高于最大可能速率，则 该速率限制不会影响结果。该速率的目标是按照一条泊松分布的调度时间线开始事务。期望的开始 时间表会基于客户端第一次开始的时间（而不是上一个事务结束的时 间）前移。这种方法意味着当事务超过它们的原定结束时间时，更迟的 那些有机会再次追赶上来。当限流措施被激活时，运行结束时报告的事务延迟是从预订的开始时间计 算而来的，因此它包括每一个事务不得不等待前一个事务结束所花的时 间。该等待时间被称作调度延迟时间，并且它的平均值和最大值也会被 单独报告。关于实际事务开始时间的事务延迟（即在数据库中执行事务 所花的时间）可以用报告的延迟减去调度延迟时间计算得到。如果把 --latency-limit 和 --rate 一起使用， 当一个事务在前一个事务结束时已经超过了延迟限制时，它可能会滞后 非常多，因为延迟是从计划的开始时间计算得来。这类事务不会被发送 给服务器，而是一起被跳过并且被单独计数。一个高的调度延迟时间表示系统无法用选定的客户端和线程数按照指定 的速率处理事务。当平均的事务执行时间超过每个事务之间的调度间隔时，每一个后续事务将会落后更多，并且随着测试运行时间越长，调度延迟时间将持续增加。发生这种情况时，你将不得不降低指定的事务速率。

在pgbench的输出中报告指定的比例因子。对于内建测试，这并非必需；正确的比例因子将通过对 pgbench_branches 表中的行计数来检测。不过，当只测试自定义基准（ -f 选项）时，比例因子将被报告为 1（除非使用了这个选项）。

执行内建的只有选择的脚本。是 -b select-only 简写形式。

每个客户端运行的事务数量。默认为 10。

运行测试这么多秒，而不是为每个客户端运行固定数量的事务。-t 和 -T 是互斥的。

在运行测试前清理所有四个标准的表。在没有用 -n 以及 -v 时， pgbench将清理 pgbench_tellers 和 pgbench_branches 表，并且截断 pgbench_history。

聚集区间的长度（单位是秒）。仅可以与 -l 选项一起使用。通过这个选项，日志会包含针对每个区间的概要数据，如下文所述。

设置 --log 创建的日志文件的文件名前缀。默认是 pgbench_log。

当显示进度（选项 -P ）时，使用一个时间戳（Unix 时间）取代从运行开始的秒数。单位是秒，在小数点后是毫秒精度。这可以有助于比较多种工具生成的日志。

设置随机数生成器种子。为系统的随机数生成器提供种子，然后随机数生成器会产生一个初始生成器状态序列，每一个线程一个状态。seed 的值可以是： time （默认值，种子基于当前时间）、 rand （使用一种强随机源，如果没有可用的源则失败）或者一个无符号十进制整数值。一个pgbench脚本中会显式（ random…​ 函数）地或者隐式地（如 --rate 使用随机数生成器调度事务）调用随机数生成器。在被明确设置时，用作种子的值会显示在终端上。 还可以通过环境变量 PGBENCH_RANDOM_SEED 提供用于 seed 的值。为了确保所提供的种子影响所有可能的使用，把这个选项放在第一位或者使用环境变量。明确地设置种子允许准确地再生一个 pgbench 运行，对随机数而言。因为随机状态是针对每个线程管理，这意味着如果每一个线程有一个客户端并且没有外部或者数据依赖，则对于一个相同的调用就会有完全相同的 pgbench 运行。从一种统计的角度来看，再生运行不是什么好主意，因为它能隐藏性能可变性或者不正当地改进性能，即通过命中前一次运行的相同页面来改进性能。不过，它也可以对调试起到很大帮助作用，例如重新运行一种导致错误的棘手用例。请善用。

采样率，在写入数据到日志时被用来减少日志产生的数量。如果给出这个选项，只有指定比例的事务被记录。1.0 表示所有事务都将被记录，0.05 表示只有 5% 的事务会被记录。在处理日志文件时，记得要考虑这个采样率。例如，当计算TPS值时，你需要相应地乘以这个数字（例如，采样率是 0.01，你将只能得到实际TPS的 1/100）。

在 stderr 上显示内置脚本 scriptname 的实际代码，并立即退出。

pgbench 还接受以下用于连接参数的常见命令行参数：

数据库服务器的主机名

数据库服务器的端口号

要作为哪个用户连接

打印pgbench版本并退出。

显示有关pgbench命令行参数的信息，并且退出。

成功运行将以状态0退出。 退出状态为1表示静态问题，如无效的命令行选项。 运行过程中的错误，例如数据库错误或脚本中的问题将导致退出状态为2。 在后一种情况下，pgbench将打印部分结果。

默认连接参数。

此实用程序与大多数其他 IvorySQL 实用程序一样，使用 libpq 支持的环境变量。

环境变量 PG_COLOR 指定是否在诊断消息中使用颜色。 可能的值是 always、 auto 和 never.

pg_config [option…​]

要使用pg_config，提供一个或多个下列选项：

打印用户可执行文件的位置。例如使用这个选项来寻找 psql 程序。这通常也是 pg_config 程序所在的位置。

打印文档文件的位置。

打印 HTML 文档文件的位置。

打印客户端接口的 C 头文件的位置。

打印其它 C 头文件的位置。

打印用于服务器编程的 C 头文件的位置。

打印对象代码库的位置。

打印动态可载入模块的位置，或者服务器可能搜索它们的位置（其它架构独立数据文件可能也被安装在这个目录）。

打印区域支持文件的位置（如果在IvorySQL被编译时没有配置区域支持，这将是一个空字符串）。

打印手册页的位置。

打印架构独立支持文件的位置。

打印系统范围配置文件的位置。

打印扩展 makefile 的位置。

打印当IvorySQL被配置编译时给予 configure 脚本的选项。这可以被用来重新得到相同的配置，或者找出是哪个选项编译了一个二进制包（不过注意二进制包通常包含厂商相关的自定补丁）。参见下面的例子。

打印用来编译IvorySQL的 CC 变量值。这显示被使用的 C 编译器。

打印用来编译IvorySQL的 CPPFLAGS 变量值。这显示在预处理时需要的 C 编译器开关（典型的是 -I 开关）。

打印用来编译IvorySQL的 CFLAGS 变量值。这显示被使用的 C 编译器开关。

打印用来编译IvorySQL的 CFLAGS_SL 变量值。这显示被用来编译共享库的额外 C 编译器开关。

打印用来编译IvorySQL的 LDFLAGS 变量值。这显示链接器开关。

打印用来编译IvorySQL的 LDFLAGS_EX 变量值。这只显示被用来编译可执行程序的链接器开关。

打印用来编译IvorySQL的 LDFLAGS_SL 变量值。这只显示被用来编译共享库的链接器开关。

打印用来编译IvorySQL的 LIBS 变量值。这通常包含用于链接到IvorySQL中的外部库的 -l 开关。

打印IvorySQL的版本。

显示有关pg_config命令行参数的帮助并退出。

如果给定多于一个选项，将按照相同的顺序打印信息，每行一项。如果没有给定选项，将打印所有可用信息，并带有标签。

要重建当前 IvorySQL 安装的编译配置，可运行下列命令：

pg_config --configure 的输出包含 shell 引号，这样带空格的参数可以被正确地表示。因此，为了得到正确的结果需要使用 eval。

pg_dump [connection-option…​] [option…​] [dbname]

下列命令选项控制输出的内容和格式。

指定要被转储的数据库名。如果没有指定，将使用环境变量 PGDATABASE。如果环境变量也没有设置，则使用指定给该连接的用户名。

只转储数据，而不转储模式（数据定义）。表数据、大对象和序列值都会被转储。这个选项类似于指定 --section=data，但是由于历史原因又不完全相同。

在转储中包括大对象。这是当 --schema、 --table 或 --schema-only 被指定时的默认行为。因此，只有在请求转储一个特定方案或者表的情况中， -b 开关才对向转储中加入大对象有用。注意blobs是被考虑的数据，因此在使用 --data-only 时将被包括在内，但在使用 --schema-only 时则不会包括。

在转储中排除大对象。当同时给定 -b 和 -B 时，行为是在数据被转储时输出大对象，请参考 -b 文档。

在输出创建数据库对象的命令之前输出清除（删除）它们的命令 （除非也指定了 --if-exists，如果任何对象不存在于 目的数据库中，恢复可能会产生一些伤害性的错误消息）。当发出归档(非文本)输出文件时，这个选项被忽略。对于归档格式，你可以在调用 pg_restore 时指定该选项。

使得在输出的开始是一个创建数据库本身并且重新连接到被创建的数据库的命令（通过这种形式的一个脚本，在运行脚本之前你连接的是目标安装中的哪个数据库都没有关系）。如果也指定了 --clean，脚本会在重新连接到目标数据库之前先删除它然后再重建。通过 --create，输出还会包括数据库的注释（如果有）以及与这个数据库相关的任何配置变量设置，也就是任何提到了这个数据库的 ALTER DATABASE …​ SET …​ 命令和 ALTER ROLE …​ IN DATABASE …​ SET …​ 命令。该数据库本身的访问特权也会被转储，除非指定有 --no-acl。当发出归档(非文本)输出文件时，这个选项被忽略。对于归档格式，你可以在调用 pg_restore 时指定该选项。

只转储匹配 pattern 的扩展。 如果未指定此选项，目标数据库中的所有非系统扩展都将被转储。 通过写入多个 -e 开关，可以选择多个扩展。 pattern 参数可以理解为与psql’s \d 命令使用的规则相同的模式， 所以还可以通过在模式中写入通配符来选择多个扩展。 在使用通配符时，如果需要防止来自扩展通配符的shell，请小心的引用模式。任何由 pg_extension_config_dump 注册的配置关系被包括在转储中，如果他的扩展已经被 -−extension 指定了。注意当指定了 -e ，pg_dump不尝试转储任何所选扩展可能依赖的其他数据库对象。 也就是说，这里不保证指定扩展转储的结果能够由他们自己成功恢复到一个干净的数据库中。

以指定的字符集编码创建转储。 在默认情况下，该转储会以该数据库的编码创建（另一种得到相同结果的方式是将 PGCLIENTENCODING 环境变量设置成想要的转储编码）。

将输出发送到指定文件。对于基于输出格式的文件这个参数可以被忽略，在那种情况下将使用标准输出。不过对于目录输出格式必须给定这个参数，在目录输出格式中指定的是一个目录而不是一个文件。在这种情况中，该目录会由 pg_dump 创建并且不需要以前就存在。

选择输出的格式。format 可以是下列之一： p plain 输出一个纯文本形式的SQL脚本文件（默认值）。c custom 输出一个适合于作为pg_restore输入的自定义格式归档。和目录输出格式一起，这是最灵活的输出格式，它允许在恢复时手动选择和排序已归档的项。这种格式在默认情况还会被压缩。 d directory 输出一个适合作为pg_restore输入的目录格式归档。这将创建一个目录，其中每个被转储的表和大对象都有一个文件，外加一个所谓的目录文件，该文件以一种pg_restore能读取的机器可读格式描述被转储的对象。一个目录格式归档能用标准 Unix 工具操纵，例如一个未压缩归档中的文件可以使用gzip工具压缩。这种格式默认情况下是被压缩的并且也支持并行转储。t tar 输出一个适合于输入到pg_restore中的 tar -格式归档。tar 格式可以兼容目录格式，抽取一个 tar 格式的归档会产生一个合法的目录格式归档。不过，tar 格式不支持压缩。还有，在使用 tar 格式时，表数据项的相对顺序不能在恢复过程中被更改。

通过同时归档 njobs 个表来运行并行转储。这个选项可能会减少执行转储所需的时间，但也会增加数据库服务器上的负载。你只能和目录输出格式一起使用这个选项，因为这是唯一一种让多个进程能在同一时间写其数据的输出格式。pg_dump将打开 njobs + 1 个到该数据库的连接，因此确保你的 max_connections 设置足够高以容纳所有的连接。在运行一次并行转储时请求数据库对象上的排他锁可能导致转储失败。 其原因是，pg_dump领导者进程会在工作者进程将要稍后转储的对象上请求共享锁，以便确保在转储运行时不会有人删除它们并让它们出错。 如果另一个客户端接着请求一个表上的排他锁，那个锁将不会被授予但是会被排入队列等待领导者进程的共享锁被释放。 因此，任何其他对该表的访问将不会被授予或者将排在排他锁请求之后。 这包括尝试转储该表的工作者进程。如果没有任何防范措施，这可能会是一种经典的死锁情况。 要检测这种冲突，pg_dump工作者进程使用 NOWAIT 选项请求另一个共享锁。 如果该工作者进程没有被授予这个共享锁，其他某人必定已经在同时请求了一个排他锁并且没有办法继续转储，因此pg_dump除了中止转储之外别无选择。对于一个一致的备份，数据库服务器需要支持同步的快照，在IvorySQL的主服务器和10的后备服务器中引入了一种特性。 有了这种特性，即便数据库客户端使用不同的连接，也可以保证他们看到相同的数据集。 pg_dump -j 使用多个数据库连接，它用领导者进程连接到数据一次，并且为每一个工作者任务再一次连接数据库。 如果没有同步快照特征，在每一个连接中不同的工作者任务将不能被保证看到相同的数据，这可能导致一个不一致的备份。

只转储匹配 pattern 的模式，这会选择模式本身以及它所包含的所有对象。当没有指定这个选项时，目标数据库中所有非系统模式都将被转储。多个模式可以通过书写多个 -n 开关来选择。另外， pattern 参数可以被解释为一种根据psql’s \d 命令所用的相同规则（请参见下面的 Patterns）编写的模式，这样多个模式也可以通过在该模式中书写通配字符来选择。在使用通配符时，如果需要阻止 shell 展开通配符需要小心引用该模式，注意当 -n 被指定时，pg_dump不会尝试转储所选模式可能依赖的任何其他数据库对象。因此，无法保证一次指定模式转储的结果能够仅凭其本身被成功地恢复到一个干净的数据库中。注意当 -n 被指定时，非模式对象（如二进制大对象）不会被转储。你可以使用 --blobs 开关将二进制大对象加回到该转储中。

不转储匹配 pattern 模式的任何模式。该模式被根据 -n 所用的相同规则被解释。-N 可以被给定多次来排除匹配几个模式中任意一个的模式。当 -n 和 -N 都被给定时，该行为是只转储匹配至少一个 -n 开关但是不匹配 -N 开关的模式。如果只有 -N 而没有 -n，那么匹配 -N 的模式会被从一个正常转储中排除。

不输出设置对象拥有关系来匹配原始数据库的命令。默认情况下，pg_dump会发出`ALTER OWNER` 或 SET SESSION AUTHORIZATION 语句来设置被创建的数据库对象的拥有关系。除非该脚本被一个超级用户（或是拥有脚本中所有对象的同一个用户）启动，这些语句都将会失败。要使一个脚本能够被任意用户恢复，但把所有对象的拥有关系都给这个用户，可指定 -O。当发出归档(非文本)输出文件时，这个选项被忽略。对于归档格式，你可以在调用`pg_restore`时指定该选项。

这个选项已经废弃，但是为了向后兼容仍然能被接受。

只转储对象定义（模式），而非数据。这个选项是 --data-only 的逆选项。它和指定 --section=pre-data --section=post-data 相似，但是由于历史原因又不完全相同。（不要把这个选项和 --schema 选项混淆，后者在“schema”的使用上有不同的含义）。要为数据库中表的一个子集排除表数据，见 --exclude-table-data。

指定要在禁用触发器时使用的超级用户的用户名。只有使用 --disable-triggers 时，这个选项才相关（通常，最好省去这个选项，而作为超级用户来启动结果脚本来取而代之）。

只转储名字匹配 pattern 的表。通过写多个 -t 开关可以选择多个表。另外，pattern 参数可以被解释为一种根据psql’s \d 命令所用的相同规则编写的模式，这样多个表也可以通过在该模式中书写通配字符来选择。在使用通配符时，如果需要阻止 shell 展开通配符需要小心引用该模式，当 -t 被使用时，-n 和 -N 开关不会有效果，因为被 -t 选择的表将被转储而无视那些开关，并且非表对象将不会被转储。注意当 -t 被指定时，pg_dump不会尝试转储所选表可能依赖的任何其他数据库对象。因此，无法保证一次指定表转储的结果能够仅凭其本身被成功地恢复到一个干净的数据库中。

不转储匹配 pattern 模式的任何表。该模式被根据 -t 所用的相同规则被解释。-T 可以被给定多次来排除匹配几个模式中任意一个的模式。当 -t 和 -T 都被给定时，该行为是只转储匹配至少一个 -t 开关但是不匹配 -T 开关的表。如果只有 -T 而没有 -t，那么匹配 -T 的表会被从一个正常转储中排除。

指定冗长模式。这将导致pg_dump向标准错误输出详细的对象注释以及转储文件的开始/停止时间，还有进度消息。 重复该选项会导致在标准错误上出现附加的调试级消息。

pg_dump版本并退出。

防止转储访问特权（授予/收回命令）。

指定要使用的压缩级别。零意味着不压缩。对于自定义和目录归档格式，这会指定个体表数据段的压缩，并且默认是进行中等级别的压缩。对于纯文本输出，设置一个非零压缩级别会导致整个输出文件被压缩，就好像它被gzip处理过一样，但是默认是不压缩。tar 归档格式当前完全不支持压缩。

这个选项用于就地升级功能。我们不推荐也不支持把它用于其他目的。这个选项在未来的发行中可能被改变而不做通知。

将数据转储为带有显式列名的 INSERT 命令（ INSERT INTO table (column, …​) VALUES …​）。这将使得恢复过程非常慢，这主要用于使转储能够被载入到非IvorySQL数据库中。重新加载期间的任何错误都将导致有问题的 INSERT 相关的行将丢失，而不是整个表内容。

这个选项禁止在函数体中使用美元符号引用，并且强制它们使用 SQL 标准字符串语法被引用。

只有在创建一个只转储数据的转储时，这个选项才相关。它指示pg_dump包括在数据被重新载入时能够临时禁用目标表上的触发器的命令。如果你在表上有引用完整性检查或其他触发器，并且你在数据重新载入期间不想调用它们，请使用这个选项。当前，为 --disable-triggers 发出的命令必须作为超级用户来执行。因此，你还应当使用 -S 指定一个超级用户名，或者宁可作为一个超级用户启动结果脚本。当发出归档(非文本)输出文件时，这个选项被忽略。对于归档格式，你可以在调用 pg_restore 时指定该选项。

只有在转储具有行安全性的表的内容时，这个选项才相关。默认情况下， pg_dump将把 row_security 设置为 off 来确保从该表中转储 出所有的数据。如果用户不具有足够能绕过行安全性的特权，那么会抛出 一个错误这个参数指示pg_dump将 row_security 设置为 on，允许用户只转储该表中 它们能够访问到的部分内容。注意如果当前你使用了这个选项，你可能还想得到 INSERT 格式的转储，因为恢复期间的 COPY FROM 不支持行安全性。

不转储匹配 pattern 模式的任何表中的数据。该模式根据 -t 的相同规则被解释。--exclude-table-data 可以被给定多次来排除匹配多个模式的表。当你需要一个特定表的定义但不想要其中的数据时，这个选项就有用了。要排除数据库中所有表的数据，见 --schema-only。

在转储浮点数据时使用规定的 extra_float_digits 值，而不是最大可用精度。以备份目的生成的常规转储不使用此选项。

时间条件性命令（即增加一个 IF EXISTS 子句）来清除数据库和其他对象。 只有同时指定了 --clean 时，这个选项才可用。

使用与 foreignserver 模式匹配的外部服务器转储任何外部表的数据。可以通过编写 多个 --include-foreign-data 开关来选择多个外部服务器。 同样，根据psql’s \d 命令使用的相同规则， 将 foreignserver 参数解释为模式。 因此也可以通过在模式中写入通配符来选择多个外部服务器。使用通配符时， 如果需要，请小心引用该模式，以防止Shell扩展通配符。 唯一的例外是不允许使用空模式。注意指定 --include-foreign-data 时，pg_dump不会检查外部表是否可写。因此，不能保证可以成功还原外部表转储的结果。

将数据转储为 INSERT 命令（而不是 COPY ）。这将使得恢复非常慢，这主要用于使转储能够被载入到非IvorySQL数据库中。重新加载期间的任何错误都将导致有问题的 INSERT 相关的行将丢失，而不是整个表内容。注意如果你已经重新安排了列序，该恢复可能会一起失败。--column-inserts 选项对于列序改变是安全的，但是会更慢。

在为一个分区表转储数据时，让 COPY 语句或者 INSERT 语句把包含它的分区层次的根而不是分区自身作为目标。这导致在数据被装载时，会为每一个行重新确定合适的分区。如果在一台服务器上重新装载数据时会出现行并不是总是落入到和原始服务器上相同的分区中的情况，这个选项就很有用。例如，如果分区列是文本类型并且两个系统中用于排序分区列的排序规则有着不同的定义，就会发生这种情况。在从用这个选项制作的归档恢复时，最好不要使用并行，因为pg_restore将不能准确地知道一个给定的归档数据项将把数据装载到哪个分区中。这会导致效率不高，因为在并行任务见会有锁冲突，或者甚至可能由于在所有的相关数据被装载前建立了外键约束而导致重新装载失败。

在转储的开始从不等待共享表锁的获得。而是在指定的 timeout 内不能锁定一个表时失败。超时时长可以用 SET statement_timeout 接受的任何格式指定。

不转储注释。

不转储publication。

不转储安全标签。

不转储订阅。

默认情况下，pg_dump 将等待所有文件被安全地写入磁盘。这个选项会让 pg_dump 不等待直接返回，这样会更快，但是也意味着后续的一次操作系统崩溃会让该转储损坏。通常这个选项对测试有用，但是不应该在从生产安装中转储数据时使用。

不要输出选择表空间的命令。通过这个选项，在恢复期间所有的对象都会被创建在任何作为默认的表空间中。当发出归档(非文本)输出文件时，这个选项被忽略。对于归档格式，你可以在调用 pg_restore 时指定该选项。

不要输出命令以设置 TOAST 压缩方法。 采用这个选项，所有列将按默认压缩设置进行恢复。

不转储非日志记录表的内容。这个选项对于表定义（模式）是否被转储没有影响，它只会限制转储表数据。当从一个后备服务器转储时，在非日志记录表中的数据总是会被排除。

增加 ON CONFLICT DO NOTHING 到 INSERT commands。 除非规定了 --inserts, --column-inserts 或 --rows-per-insert ，否则此选项是无效的.

强制引用所有标识符。当从IvorySQL主版本与pg_dump不同的服务器上转储一个数据库时或者当输出准备载入到一个具有不同主版本的服务器时，推荐使用这个选项。默认情况下，pg_dump只对在其主版本中是被保留词的标识符加上引号。在转储其他版本服务器时，这种默认行为有时会导致兼容性问题，因为那些版本可能具有些许不同的被保留词集合。使用 --quote-all-identifiers 能阻止这种问题，但代价是转储脚本更难阅读。

数据转储为 INSERT 命令（而不是 COPY ）。 控制每个 INSERT 命令的最大行数。 指定的值必须大于零。重新加载期间的任何错误都将导致有问题的`INSERT` 相关的行将丢失，而不是整个表内容。

只转储命名节。节的名称可以是 pre-data、 data 或 post-data。这个选项可以被指定多次来选择多个节。默认是转储所有节。数据节包含真正的表数据、大对象内容和序列值。数据后项包括索引、触发器、规则和除了已验证检查约束之外的约束的定义。数据前项包括所有其他数据定义项。

为转储使用一个 可序列化 事务，以保证所使用的快照与后来的数据库状态是一致的。但是这样做是在事务流中等待一个点，在该点上不能存在异常，这样就不会有转储失败或者导致其他事务带着 serialization_failure 回滚的风险。对于一个只为灾难恢复存在的转储，这个选项没什么益处。如果一个转储被用来在原始数据库持续被更新期间载入一份用于报表或其他只读负载的数据库拷贝时，这个选项就有所帮助。如果没有这个选项，转储可能会反映一个与最终提交事务的任何执行序列都不一致的状态。例如，如果使用了批处理技术，一个批处理在转储中可以显示为关闭，而其中的所有项都不出现。如果 pg_dump 被启动时没有读写事务在活动，则这个选项没有什么不同。如果有读写事务在活动，该转储的启动可能会被延迟一段不确定的时间。一旦开始运行，有没有这个开关的表现是相同的。

在做一个数据库的转储时指定一个同步的快照。在需要把转储和一个逻辑复制槽 或者一个并发会话同步时可以用上这个选项。在并行转储的情况下，将使用这个选项指定的快照名而不是取一个新快照。

要求每一个扩展( -e / --extension )，模式（ -n / --schema ）和表（ -t / --table ）限定符匹配要转储的数据库中至少一个扩展/模式/表。 注意，如果没有找到有这样的扩展/模式/表限定符匹配，即便没有 --strict-names ，pg_dump也将生成一个错误。这个选项对 -N / --exclude-schema、-T / --exclude-table 或者 --exclude-table-data 没有效果。无法匹配任何对象的排除模式不会被当作错误。

输出 SQL-标准的 SET SESSION AUTHORIZATION 命令取代 ALTER OWNER 命令来确定对象的所有关系。这让该转储更加兼容标准，但是取决于该转储中对象的历史，该转储可能无法正常恢复。而且，一个使用 SET SESSION AUTHORIZATION 的转储将一定会要求超级用户特权来正确地恢复，而 ALTER OWNER 要求更少的特权。

显示有关pg_dump命令行参数的帮助并退出。

下列命令行选项控制数据库连接参数。

指定要连接的数据库的名称。 这等效于在命令行上将 dbname 指定为第一个非选项参数。dbname 可以是 连接字符串。 如果是这样，连接字符串参数将覆盖所有冲突的命令行选项。

指定服务器正在运行的机器的主机名。如果该值开始于一个斜线，它被用作一个 Unix 域套接字的目录。默认是从 PGHOST 环境变量中取得（如果被设置），否则将尝试一次 Unix 域套接字连接。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。默认是放在`PGPORT`环境变量中（如果被设置），否则使用编译在程序中的默认值。

要作为哪个用户连接。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那么连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制pg_dump在连接到一个数据库之前提示要求一个口令。这个选项从来不是必须的，因为如果服务器要求口令认证，pg_dump将自动提示要求一个口令。但是，pg_dump将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下，值得键入`-W`来避免额外的连接尝试。

指定一个用来创建该转储的角色名。这个选项导致pg_dump在连接到数据库后发出一个 SET ROLE rolename 命令。当已认证用户（由 -U 指定）缺少pg_dump所需的特权但是能够切换到一个具有所需权利的角色时，这个选项很有用。一些安装有针对直接作为超级用户登录的策略，使用这个选项可以让转储在不违反该策略的前提下完成。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。.

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

pg_dump在内部执行 SELECT 语句。如果你运行pg_dump时出现问题，确定你能够从正在使用的数据库中选择信息，例如 psql。此外，libpq前端-后端库所使用的任何默认连接设置和环境变量都将适用。

pg_dump的数据库活动会被统计收集器正常地收集。如果不想这样，你可以通过 PGOPTIONS 或 ALTER USER 命令设置参数 track_counts 为假。

如果你的数据库集簇对于 template1 数据库有任何本地添加，要注意将pg_dump的输出恢复到一个真正的空数据库。否则你很可能由于以增加对象的重复定义而得到错误。要创建一个不带任何本地添加的空数据库，从 template0 而不是 template1 复制它，例如：

当一个只含数据的转储被选中并且使用了选项 --disable-triggers 时，pg_dump在开始插入数据之前会发出命令禁用用户表上的触发器，并且接着在数据被插入之后发出命令重新启用它们。如果恢复中途被停止，系统目录可能会停留在一种错误状态。

pg_dump产生的转储文件不包含优化器用来做出查询计划决定的统计信息。因此，在从一个转储文件恢复后运行 ANALYZE 来确保最优性能是明智的。

在转储逻辑复制订阅时，pg_dump将生成使用 connect = false 选项的 CREATE SUBSCRIPTION 命令，这样恢复订阅时不会建立远程连接来创建复制槽或者进行初始的表拷贝。通过这种方式，可以无需到远程服务器的网络访问就能恢复该转储。然后就需要用户以一种合适的方式重新激活订阅。如果涉及到的主机已经改变，连接信息可能也必须被改变。在开启一次新的全表拷贝之前，截断目标表也可能是合适的。

要把一个数据库 mydb 转储到一个 SQL 脚本文件：

要把这样一个脚本重新载入到一个（新创建的）名为 newdb 的数据库中：

要转储一个数据库到一个自定义格式归档文件：

要转储一个数据库到一个目录格式的归档：

要用 5 个并行的工作者任务转储一个数据库到一个目录格式的归档：

要把一个归档文件重新载入到一个（新创建的）名为 newdb 的数据库：

把一个归档文件重新装载到同一个数据库（该归档正是从这个数据库中转储得来）中，丢掉那个数据库中的当前内容：

要转储一个名为 mytab 的表：

要转储 detroit 模式中名称以 emp 开始的所有表，排除名为 employee_log 的表：

要转储名称以 east 或者 west 开始并且以 gsm 结束的所有模式，排除名称包含词`test`的任何模式：

同样，用正则表达式记号法来合并开关：

要转储除了名称以 ts_ 开头的表之外的所有数据库对象：

要在 -t 和相关开关中指定一个大写形式或混合大小写形式的名称，你需要双引用该名称，否则它会被折叠到小写形式 。但是双引号对于 shell 是特殊的，所以反过来它们必须被引用。因此， 要转储一个有混合大小写名称的表，你需要类似这样的东西：

pg_dumpall [connection-option…​] [option…​]

pg_dumpall工具可以一个集簇中所有的IvorySQL数据库写出到（“转储”）一个脚本文件。该脚本文件包含可以用作 psql 的输入SQL命令来恢复数据库。它会对集簇中的每个数据库调用 pg_dump 来完成该工作。pg_dumpall还转储对所有数据库公用的全局对象（ pg_dump 不保存这些对象），也就是说数据库角色和表空间都会被转储。 目前这包括适数据库用户和组、表空间以及适合所有数据库的访问权限等属性。

因为pg_dumpall从所有数据库中读取表，所以你很可能需要以一个数据库超级用户的身份连接以便生成完整的转储。同样，你也需要超级用户特权执行保存下来的脚本，这样才能增加角色和组以及创建数据库。

SQL 脚本将被写出到标准输出。使用 -f / --file 选项或者 shell 操作符可以把它重定向到一个文件。

pg_dumpall需要多次连接到IvorySQL服务器（每个数据库一次）。如果你使用口令认证，可能每次都会要求口令。这种情况下使用一个 ~/.pgpass 会比较方便。

下列命令行选项用于控制输出的内容和格式。

只转储数据，不转储模式（数据定义）。

包括在重建数据库之前清除（移除）它们的 SQL 命令。角色和表空间的 DROP 命令也会被加入进来。

用指定的字符集编码创建转储。默认情况下，转储使用数据库的编码创建（另一种得到相同结果的方法是设置 PGCLIENTENCODING 环境变量为想要的转储编码）。

将输出发送到指定的文件中。如果省略，将使用标准输出。

只转储全局对象（角色和表空间），而不转储数据库。

不输出用于设置对象所有权以符合原始数据库的命令。默认情况下，pg_dumpall发出 ALTER OWNER 或 SET SESSION AUTHORIZATION 语句来设置被创建的模式元素的所有权。除非脚本是由一个超级用户（或者是拥有脚本中所有对象的同一个用户）所运行，这些语句在脚本运行时会失败。要使得一个脚本能被任意用户恢复，但又不想给予该用户所有对象的所有权，可以指定 -O。

只转储角色，不转储数据库和表空间。

只转储对象定义（模式），不转储数据。

指定要在禁用触发器时使用的超级用户的用户名。只有使用 --disable-triggers 时，这个选项才相关（通常，最好省去这个选项，而作为超级用户来启动结果脚本来取而代之）。

只转储表空间，不转储数据库和角色。

指定细节模式。这将导致pg_dumpall向标准错误输出详细的对象注释以及转储文件的开始/停止时间，还有进度消息。 重复该选项会导致在标准错误上出现附加的调试级信息。 这个选项还会被传递到pg_dump。

打印pg_dumpall版本并退出。

防止转储访问特权（授予/收回命令）。

这个选项用于就地升级功能。我们不推荐也不支持把它用于其他目的。这个选项在未来的发行中可能被改变而不做通知。

将数据转储为带有显式列名的 INSERT 命令（INSERT INTO table(column, …​) VALUES …​）。这将使得恢复过程非常慢，这主要用于使转储能够被载入到非IvorySQL数据库中。

这个选项禁止在函数体中使用美元符号引用，并且强制它们使用 SQL 标准字符串语法被引用。

只有在创建一个只转储数据的转储时，这个选项才相关。它指示pg_dumpall包括在数据被重新载入时能够临时禁用目标表上的触发器的命令。如果你在表上有引用完整性检查或其他触发器，并且你在数据重新载入期间不想调用它们，请使用这个选项。当前，为 --disable-triggers 发出的命令必须作为超级用户来执行。因此，你还应当使用 -S 指定一个超级用户名，或者宁可作为一个超级用户启动结果脚本。

不要转储名字与 pattern 匹配的数据库。可以通过编写多个 --exclude-database 开关来排除多个模式。 pattern 参数被解释为模式，根据psql的 \d 命令使用的相同规则 ，因此，通过在模式中编写通配符也可以排除多个数据库。 使用通配符时，请谨慎的引用模式，如果需要防止shell通配符扩展。

在转储浮点数据时使用extra_float_digits规定的值，而不是最大可用精度。备份目的进行的常规转储不使用此选项。

时间条件性命令（即增加一个 IF EXISTS 子句）来清除数据库和其他对象。 只有同时指定了 --clean 时，这个选项才可用。

将数据转储为 INSERT 命令（而不是 COPY ）。这将使得恢复非常慢，这主要用于使转储能够被载入到非IvorySQL数据库中。注意如果你已经重新安排了列序，该恢复可能会一起失败。--column-inserts 选项对于列序改变是安全的，但是会更慢。

在为一个分区表转储数据时，让 COPY 语句或者 INSERT 语句把包含它的分区层次的根而不是分区自身作为目标。这导致在数据被装载时，会为每一个行重新确定合适的分区。如果在一台服务器上重新装载数据时会出现行并不是总是落入到和原始服务器上相同的分区中的情况，这个选项就很有用。例如，如果分区列是文本类型并且两个系统中用于排序分区列的排序规则有着不同的定义，就会发生这种情况。

在转储的开始从不等待共享表锁的获得。 而是在指定的 timeout 内不能锁定一个表时失败。 超时时长可以用 SET statement_timeout 接受的任何格式指定。

不转储注释。

不转储publication。

不为角色转储口令。在恢复完后，角色的口令将是空口令，并且在设置口令之前口令认证都不会成功。由于指定这个选项时并不需要口令值，角色信息将从目录视图 pg_roles 而不是 pg_authid 中读出。因此，如果对 pg_authid 的访问被某条安全性策略所限制，那么这个选项也会有所帮助。

不转储安全标签。

不转储subscription。

默认情况下，pg_dumpall 将等待所有文件被安全地写入到磁盘。这个选项会让 pg_dumpall 不做这种等待而返回，这样会更快，但是意味着后续的操作系统崩溃可能留下被损坏的转储。通常来说，这个选项对测试有用，但不应该在从生产安装中转储数据时使用。

不要输出选择表空间的命令。通过这个选项，在恢复期间所有的对象都会被创建在任何作为默认的表空间中。

不要输出命令以设置 TOAST 压缩方法。 采用这个选项，所有列将会以默认压缩设置来恢复。

不转储非日志记录表的内容。这个选项对于表定义（模式）是否被转储没有影响，它只会限制转储表数据。

添加 ON CONFLICT DO NOTHING 到 INSERT 命令。 除非 --inserts 或 --column-inserts 也被规定，否则此选项不生效。

强制引用所有标识符。在从一个与pg_dumpall主版本不同的IvorySQL服务器转储数据库时或者要将输出载入到一个不同主版本的服务器时，推荐使用这个选项。默认情况下，pg_dumpall只会对为其主版本中保留词的标识符加上引号。在与其他版本的具有不同保留词集合的服务器交互时，这有时会导致兼容性问题。使用 --quote-all-identifiers 可以阻止这类问题，但是代价是转储脚本会更加难读。

将数据转储为 INSERT 命令（而不是 COPY ）。控制每个 INSERT 命令的最大行数。 指定的值必须是大于零的数。重新加载期间的任何错误都将导致仅丢失有问题的 INSERT 的行，而不是整个表内容。

输出 SQL-标准的 SET SESSION AUTHORIZATION 命令取代 ALTER OWNER 命令来确定对象的所有关系。这让该转储更加兼容标准，但是取决于该转储中对象的历史，该转储可能无法正常恢复。

显示有关pg_dumpall命令行参数的帮助并退出。

下列命令行选项控制数据库连接参数。

指定用于连接到服务器的参数，比如 连接字符串；这些将覆盖所有冲突的命令行选项。这个选项被称为 --dbname 是为了和其他客户端应用一致，但是因为pg_dumpall需要连接多个数据库，连接字符串中的数据库名将被忽略。使用 -l 选项指定一个数据库，该数据库被用于初始连接，这将转储全局对象并且发现需要转储哪些其他数据库。

指定服务器正在运行的机器的主机名。如果该值开始于一个斜线，它被用作一个 Unix 域套接字的目录。默认是从 PGHOST 环境变量中取得（如果被设置），否则将尝试一次 Unix 域套接字连接。

指定要连接到哪个数据库转储全局对象以及发现要转储哪些其他数据库。如果没有指定，将会使用 postgres 数据库，如果 postgres 不存在，就使用 template1。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。默认是放在 PGPORT 环境变量中（如果被设置），否则使用编译在程序中的默认值。

要作为哪个用户连接。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制pg_dumpall在连接到一个数据库之前提示要求一个口令。这个选项从来不是必须的，因为如果服务器要求口令认证，pg_dumpall将自动提示要求一个口令。但是，pg_dumpall将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下，值得键入 -W 来避免额外的连接尝试。注意对每个要被转储的数据库，口令提示都会再次出现。通常，最好设置一个 ~/.pgpass 文件来减少手工口令输入。

指定一个用来创建该转储的角色名。这个选项导致pg_dump在连接到数据库后发出一个 SET ROLE rolename 命令。当已认证用户（由 -U 指定）缺少pg_dump所需的特权但是能够切换到一个具有所需权利的角色时，这个选项很有用。一些安装有针对直接作为超级用户登录的策略，使用这个选项可以让转储在不违反该策略的前提下完成。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

因为pg_dumpall在内部调用pg_dump，所以， 一些诊断消息可以参考pg_dump。

即使当用户的目的是把转储脚本恢复到一个空的集簇中，--clean 选项也有用武之地。--clean 的使用让该脚本删除并且重建内建的 postgres 和 template1 数据库，确保这两个数据库保持与源集簇中相同的属性（例如locale和编码）。如果不用这个选项，这两个数据库将保持它们现有的数据库级属性以及任何已有的内容。

一旦恢复，建议在每个数据库上运行 ANALYZE，这样优化器就可以得到有用的统计信息。你也可以运行 vacuumdb -a -z 来分析所有数据库。

不应该预期转储脚本运行到结束都不出错。特别是由于脚本将为源集簇中已有的每一个角色发出 CREATE ROLE 语句，对于bootstrap超级用户当然会得到一个“role already exists”错误，除非目标集簇用一个不同的bootstrap超级用户名完成的初始化。这种错误是无害的并且应该被忽略。--clean 选项的使用很可能会产生额外的有关于不存在对象的无害错误消息，不过可以通过加上 --if-exists 减少这类错误消息。

pg_dumpall要求所有需要的表空间目录在进行恢复之前就必须存在；否则，数据库创建就会由于在非默认位置创建数据库而失败。

要转储所有数据库：

要从这个文件重新载入数据库，你可以使用：

这里你连接哪一个数据库并不重要，因为由pg_dumpall创建的脚本将包含合适的命令来创建和连接到被保存的数据库。一个例外是，如果指定了 --clean，则开始时必须连接到 postgres 数据库，该脚本将立即尝试删除其他数据库，并且这种动作对于已连接上的这个数据库将会失败。

pg_isready [connection-option…​] [option…​]

指定要连接的数据库名。dbname 可以是连接字符串。如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。默认值取自 PGPORT 环境变量。如果环境变量没有设置，则默认值使用编译时指定的端口（通常是 5432）。

不显示状态消息。当脚本编程时有用。

尝试连接时，在返回服务器不响应之前等待的最大秒数。设置为 0 则禁用。默认值是 3 秒。

作为用户 username 连接数据库，而不是用默认用户。

打印pg_isready版本并退出。

显示有关pg_isready命令行参数的帮助并退出。

如果服务器正常接受连接，pg_isready返回 0 给 shell；如果服务器拒绝连接（例如处于启动阶段）则返回 1；如果连接尝试没有被相应则返回 2；如果没有尝试（例如由于非法参数）则返回 3。

和大部分其他IvorySQL工具相似，pg_isready 也使用libpq支持的环境变量。

环境变量 PG_COLOR 规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

要获得服务器状态，不一定需要提供正确的用户名、口令或数据库名。 不过，如果提供了不正确的值，服务器将会记录一次失败的连接尝试。

标准用法：

使用连接参数运行连接到处于启动中的IvorySQL集簇：

使用连接参数运行连接到无响应的IvorySQL集簇：

pg_receivewal [option…​]

要把输出写到哪个目录。这个参数是必需的。

当接收到达指定的LSN时，自动停止复制并且以正常退出状态0退出。如果有一个记录的LSN正好等于 lsn，则该记录将会被处理。

当指定 --create-slot 并且具有指定名称的槽已经存在时不要抛出错误。

不要在连接错误上循环。相反，碰到一个错误时立刻退出。

这个选项导致 pg_receivewal 不强制WAL数据被刷回磁盘。这样会更快，但是也意味着接下来的操作系统崩溃会让WAL段损坏。通常，这个选项对于测试有用，但不应该在对生产部署进行WAL归档时使用。这个选项与 --synchronous 不兼容。

指定发送回服务器的状态包之间的秒数。这允许我们更容易地监控服务器的进度。 一个零值完全禁用这种周期性的状态更新，不过当服务器需要时还是会有一个更新 会被发送来避免超时导致的断开连接。默认值是 10 秒。

要求pg_receivewal使用一个已有的复制槽。在使用这个选项时， pg_receivewal将会报告给服务器一个刷写位置，指示每一个 段是何时被同步到磁盘的，这样服务器可以在不需要该段时移除它。当pg_receivewal的复制客户端在服务器 上被配置为一个同步后备时，那么使用一个复制槽将会向服务器报告刷写 位置，但只在一个 WAL 文件被关闭时报告。因此，该配置将导致主服务 器上的事务等待很长的时间并且无法令人满意地工作。要让这种配置工作 正确，还必须制定选项 --synchronous （见下文）。

在 WAL 数据被收到后立即刷入到磁盘。还要在刷写后立即向服务器回送 一个状态包（不考虑 --status-interval ）。如果pg_receivewal的复制客户端在服务器 上被配置为一个同步后备，应该指定这个选项来确保向服务器发送及时的反馈。

启用冗长模式。

启用预写式日志上的gzip压缩，并且指定压缩级别（0到9，0是不压缩而9是最大压缩）。所有的文件名后都将被追加后缀 .gz。

下列命令行选项控制数据库连接参数。

指定用于连接到服务器的参数，作为 连接字符串；这些将覆盖所有冲突的命令行选项。为了和其他客户端应用一致，该选项被称为 --dbname。但是因为pg_receivewal并不连接到集簇中的任何特定数据库，连接字符串中的数据库名将被忽略。

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量（如果设置），否则会尝试一个 Unix 域套接字连接。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。默认用 PGPORT 环境变量中的值（如果设置），或者一个编译在程序中的默认值。

要作为哪个用户连接。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制pg_receivewal在连接到一个数据库之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，pg_receivewal将自动提示要求一个口令。但是，pg_receivewal将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

为了控制物理复制槽，pg_receivewal 可以执行下列两种动作之一：

用 --slot 中指定的名称创建一个新的物理复制槽， 然后退出。

删除 --slot 中指定的复制槽，然后退出。

其他选项也可用：

打印pg_receivewal版本并退出。

显示有关pg_receivewal命令行参数的帮助并退出。

在被SIGINT信号终止（没有正常的方式结束它。因此这不是一种错误）时，pg_receivewal将以状态0退出。 对于致命错误或者其他信号，退出状态将不是零。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

环境变量 PG_COLOR 规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

在使用pg_receivewal替代 archive_command 作为主要的 WAL 备份方法时， 强烈建议使用复制槽。否则，服务器可能会在预写式日志文件被备份好之前重用 或者移除它们，因为没有任何信息（不管是来自 archive_command 或是复制槽）能够指示 WAL 流已 经被归档到什么程度。不过要注意，如果接收者没有持续地取走 WAL 数据， 一个复制槽将会填满服务器的磁盘空间。

如果在源集簇上启用了组权限，pg_receivewal将保留接收到的WAL文件上的组权限。

要从位于 mydbserver 的服务器流式传送预写式日志并且将它存储在本地目录`/usr/local/pgsql/archive`：

pg_recvlogical [option…​]

必须至少要指定下列选项之一来选择一个动作：

为 --dbname 指定的数据库用 --slot 指定的名称创建一个新的逻辑复制槽，使用 --plugin 指定的输出插件。

删除名称由 --slot 指定的复制槽，然后退出。

从 --slot 指定的逻辑复制槽开始进行流式传送更改，一直继续 到被一个信号终止。如果服务器端关机或者断开连接导致更改流结束，会进入一个 循环一直重试，通过指定 --no-loop 可以防止这种情况下进入循环重试。流格式由槽创建时指定的输出插件决定。连接必须是连接到用于创建该槽的同一个数据库上。

--create-slot 和 --start 可以被一起指定。 --drop-slot 不能和另一个动作组合在一起。

下面的命令行选项控制输出的位置和格式以及其他复制行为：

在 --start 模式中，当接收过程到达指定的LSN时会自动地停止复制并且以正常的退出状态0退出。如果不处于 --start 模式时指定这个选项，则会发生错误。如果有一个记录的LSN正好等于 lsn，则该记录将被输出。--endpos 不会察觉到事务边界并且可能会在一个事务中间截断输出。任何部分输出的事务都将不会被消费，并且在下一次从该槽中读取时将会重放该事务。单个的消息不会被截断。

把接收到并且解码好的事务数据写入到一个文件。使用 - 可以写到stdout。

指定pg_recvlogical发出 fsync() 调用确保输出文件被安全地刷到磁盘的频度。服务器将会偶尔要求客户端执行一次刷写并且把刷写位置报告给服务器。 这个设置可以在此之外更加频繁地执行刷写。指定间隔为 0 会完全禁止发出 fsync() 调用，但是仍会报告进度给服务器。在这种情况下，发生崩溃会导致数据丢失。

在 --start 模式中，从给定的 LSN 开始复制。

当指定 --create-slot 并且具有指定名称的槽已经存在时不要抛出错误。

当服务器连接丢失时，不要在循环中重试，直接退出。

如果指定了输出插件，把选项值 value 传递给选项 name。存在哪些选项以及它们的效果 取决于使用的输出插件。

在创建一个槽时使用指定的逻辑解码输出插件。如果该槽已经存在，这个选项没有效果。

这个选项和 pg_receivewal 中的同名选项具有相同的效果。请参考那里的描述。

在 --start 模式中，使用名为 slot_name 的已有逻辑复制槽。在 --create-slot 模式中，使用这个名称 创建该槽。在 --drop-slot 模式中，删除这个名称指定的槽。

开启详细输出模式。

下列命令行选项控制数据库连接参数。

要连接的数据库。这个选项的详细含义请见动作的描述。dbname 可以是 连接字符串。 如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。默认为用户名。

指定服务器正在运行的机器的主机名。如果该值开始于一个斜线， 它被用作一个 Unix 域套接字的目录。默认是从 `PGHOST`环境变量中取得（如果被设置）， 否则将尝试一次 Unix 域套接字连接。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。 默认是放在 PGPORT 环境变量中（如果被设置）， 否则使用编译在程序中的默认值。

要作为哪个用户连接。默认是用当前操作系统用户名。

从不发出一个口令提示。如果服务器要求口令认证并且没有 其他方式提供口令（例如一个 .pgpass 文件）， 那么连接尝试将失败。这个选项对于批处理任务和脚本有用， 因为在其中没有一个用户来输入口令。

强制pg_dump在连接到一个数据库之前提示要求一个口令。这个选项不是必须的，因为如果服务器要求口令认证， pg_dump将自动提示要求一个口令。 但是，pg_dump将浪费一次连接尝试 来发现服务器想要一个口令。在某些情况下，值得键入 -W 来避免额外的连接尝试。

还有下列附加选项可用：

打印pg_recvlogical的版本并且退出。

显示关于pg_recvlogical命令行参数的帮助，并且退出。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

环境变量`PG_COLOR`规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

如果在源服务器上启用了组权限，pg_recvlogical将会在接收到的WAL文件上保留组权限。

pg_restore [connection-option…​] [option…​] [filename]

pg_restore接受下列命令行参数。

指定要被恢复的归档文件（对于一个目录格式的归档则是目录）的位置。如果没有指定，则使用标准输入。

只恢复数据，不恢复模式（数据定义）。如果在归档中存在，表数据、大对象和序列值会被恢复。这个选项类似于指定 --section=data，但是由于历史原因两者不完全相同。

在重新创建数据库对象之前清除（丢弃）它们（除非使用了 --if-exists，如果有对象在目标数据库中不存在，这可能会生成一些无害的错误消息）。

在恢复一个数据库之前县创建它。如果还指定了 --clean，在连接到目标数据库之前丢弃并且重建它。如果使用 --create，pg_restore还会恢复数据库的注释（如果有）以及与其相关的配置变量设置，也就是任何提到过这个数据库的 ALTER DATABASE …​ SET …​ 和 ALTER ROLE …​ IN DATABASE …​ SET …​ 命令。不管是否指定 --no-acl，数据库本身的访问特权都会被恢复。在使用这个选项时，-d 提到的数据库只被用于发出初始的 DROP DATABASE 和 CREATE DATABASE 命令。所有要恢复到该数据库名中的数据都出现在归档中。

连接到数据库 dbname 并且直接恢复到该数据库中。dbname 可以是 连接字符串。 如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。

在发送 SQL 命令到该数据库期间如果碰到一个错误就退出。默认行为是继续并且在恢复结束时显示一个错误计数。

为生成的脚本指定输出文件，或在与 -l 选项一起使用时为列表指定输出文件。为 stdout用 -。

指定归档的格式。并不一定要指定该格式，因为pg_restore将会自动决定格式。如果指定，可以是下列之一：c custom 归档是pg_dump的自定义格式。d directory 归档是一个目录归档。t tar 归档是一个 tar 归档。

只恢复提及的索引的定义。可以通过写多个 -I 开关指定多个索引。

使用并发任务运行pg_restore中最耗时的步骤 — 载入数据、创建索引或者创建约束； 同时，最多使用 number-of-jobs 个并发会话。对于一个运行在多处理器机器上的服务器， 这个选项能够大幅度减少恢复一个大型数据库的时间。当发出脚本而不是直接连接到数据库服务器时，将忽略此选项。每一个任务是一个进程或者一个线程，这取决于操作系统，它们都使用一个独立的服务器连接。这个选项的最佳值取决于服务器、客户端以及网络的硬件设置。因素包括 CPU 的核心数和磁盘设置。一个好的建议是服务器上 CPU 的核心数，但是更大的值在很多情况下也能导致更快的恢复时间。当然，过高的值会由于超负荷反而导致性能降低。这个选项只支持自定义和目录归档格式。输入必须是一个常规文件或目录（例如，不能是一个管道或者标准输出）。还有，多任务不能和选项 --single-transaction 一起用。

列出归档的内容的表格。这个操作的输出能被用作 -L 选项的输入。注意如果把 -n 或 -t 这样的过滤开关与 -l 一起使用，它们将会限制列出的项。

只恢复在 list-file 中列出的归档元素，并且按照它们出现在该文件中的顺序进行恢复。注意如果把 -n 或 -t 这样的过滤开关与 -L 一起使用，它们将会进一步限制要恢复的项。list-file 通常是编辑一个 -l 操作的输出来创建。行可以被移动或者移除，并且也可以通过在行首放一个（ ; ）将其注释掉。例子见下文。

只恢复在被提及的模式中的对象。可以用多个 -n 开关来指定多个模式。这可以与`-t`选项组合在一起只恢复一个指定的表。

不恢复所提及方案中的对象。可以用多个 -N 开关指定多个要被排除的方案。如果对同一个方案名称同时给出了 -n 和 -N，则 -N 会胜出并且该方案会被排除。

不要输出将对象的所有权设置为与原始数据库匹配的命令。默认情况下，pg_restore会发出 ALTER OWNER 或者 SET SESSION AUTHORIZATION 语句来设置已创建的模式对象的所有权。除非到该数据库的初始连接是一个超级用户（或者拥有脚本中所有对象的同一个用户）建立的，这些语句将会失败。通过 -O，任何用户名都可以被用于初始连接，并且这个用户将会拥有所有被创建的对象。

只恢复被提及的函数。要小心地拼写函数的名称和参数使它们正好就是出现在转储文件的内容表中的名称和参数。可以使用多个 -P 开关指定多个函数。

这个选项已被废弃，但是出于向后兼容性的目的，系统仍然还接受它。

只恢复归档中的模式（数据定义）不恢复数据。这个选项是 --data-only 的逆选项。它与指定 --section=pre-data --section=post-data 相似，但是由于历史原因并不完全相同。（不要把这个选项和 --schema 选项弄混，后者把词“schema”用于一种不同的含义）。

指定在禁用触发器时要用的超级用户名。只有使用 --disable-triggers 时这个选项才相关。

只恢复所提及的表的定义和数据。出于这个目的，“table”包括视图、物化视图、序列和外部表。可以写上多个 -t 开关可以选择多个表。这个选项可以和 -n 选项结合在一起指定一个特定模式中的表。注意在指定 -t 时，pg_restore不会尝试恢复所选表可能依赖的任何其他数据库对象。因此，无法确保能成功地把一个特定表恢复到一个干净的数据库中。注意这个标志的行为和pg_dump的 -t 标志不一样。在pg_restore中当前没有任何通配符匹配的规定，也不能在其 -t 选项中包括模式的名称。而且，虽然pg_dump的 -t 标志也会转储选中表的附属对象（例如索引），但是pg_restore的 -t 标志不包括这些附属对象。

只恢复所提及的触发器。可以用多个 -T 开关指定多个触发器。

指定冗长模式。 这将导致pg_restore输出详细的对象注释和启动/停止时间到输出文件，并将推送消息输出到标准错误。 重复该选项会造成附加的调试级消息出现在标准报错上。

打印该pg_restore的版本并退出。

阻止恢复访问特权（授予/收回命令）。

将恢复作为单一事务执行（即把发出的命令包裹在 BEGIN / COMMIT 中）。这可以确保要么所有命令完全成功，要么任何改变都不被应用。这个选项隐含了 --exit-on-error。

只有在执行一个只恢复数据的恢复时，这个选项才相关。它指示pg_restore在装载数据时执行命令临时禁用目标表上的触发器。如果你在表上有参照完整性检查或者其他触发器并且你不希望在数据载入期间调用它们时，请使用这个选项。目前，为 --disable-triggers 发出的命令必须以超级用户身份完成。因此你还应该用`-S`指定一个超级用户名，或者更好的方法是以一个IvorySQL超级用户运行pg_restore。

只有在恢复具有行安全性的表的内容时，这个选项才相关。默认情况下，pg_restore将把 row_security 设置为 off 来确保所有数据都被恢复到表中。如果用户不拥有足够绕过行安全性的特权，那么会抛出一个错误。这个参数指示pg_restore把 row_security 设置为on允许用户尝试恢复启用了行安全性的表的内容。如果用户没有从转储向表中插入行的权限，这仍将失败。注意当前这个选项还要求转储处于 INSERT 格式，因为 COPY FROM 不支持行安全性。

使用条件命令（即增加一个 IF EXISTS 子句）删除数据库对象。只有指定了 --clean 时，这个选项才有效。

即便归档中包含注释也不输出恢复注释的命令。

默认情况下，即便表的创建命令失败（例如因为表已经存在），表数据也会被恢复。通过这个选项，对这类表的数据会被跳过。如果目标数据库已经包含了想要的表内容，这种行为又很有有用。例如，IvorySQL扩展（如PostGIS）的辅助表可能已经被载入到目标数据库中，指定这个选项就能阻止把重复的或者废弃的数据载入到这些表中。只有当直接恢复到一个数据库中时这个选项才有效，在产生 SQL脚本输出时这个选项不会产生效果。

即便归档中包含publication也不输出恢复publication的命令。

不要输出恢复安全标签的命令，即使归档中包含安全标签。

即便归档中包含subscription也不输出恢复subscription的命令。

不输出命令选择表空间。通过这个选项，所有的对象都会被创建在恢复时的默认表空间中。

只恢复提及的小节。小节的名称可以是 pre-data、data 或者 post-data。可以把这个选项指定多次来选择多个小节。默认值是恢复所有小节。数据小节包含实际的表数据以及大对象定义。Post-data 项由索引定义、触发器、规则和除已验证的检查约束之外的约束构成。Pre-data 项由所有其他数据定义项构成。

要求每一个模式（ -n / --schema）以及表（ -t / --table）限定词匹配备份文件中至少一个模式/表。

输出 SQL 标准的 SET SESSION AUTHORIZATION 命令取代 ALTER OWNER 命令来决定对象拥有权。这会让转储更加兼容标准，但是依赖于转储中对象的历史，可能无法正确恢复。

显示有关pg_restore命令行参数的帮助，并且退出。

pg_restore也接受下列用于连接参数的命令行参数：

指定服务器正在运行的机器的主机名。如果该值开始于一个斜线，它被用作一个 Unix 域套接字的目录。默认是从 PGHOST 环境变量中取得（如果被设置），否则将尝试一次 Unix 域套接字连接。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。默认是放在 PGPORT 环境变量中（如果被设置），否则使用编译在程序中的默认值。

要作为哪个用户连接。

不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那么连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制pg_restore在连接到一个数据库之前提示要求一个口令。这个选项不是必须的，因为如果服务器要求口令认证，pg_restore将自动提示要求一个口令。但是，pg_restore将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下，值得键入 -W 来避免额外的连接尝试。

指定一个用来创建该转储的角色名。这个选项导致pg_restore在连接到数据库后发出一个 SET ROLE rolename 命令。当已认证用户（由 -U 指定）缺少pg_restore所需的特权但是能够切换到一个具有所需权利的角色时，这个选项很有用。一些安装有针对直接作为超级用户登录的策略，使用这个选项可以让转储在不违反该策略的前提下完成。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

当使用 -d 选项指定一个直接数据库连接时，pg_restore在内部执行 SELECT 语句。如果你运行pg_restore时出现问题，确定你能够从正在使用的数据库中选择信息，例如 psql。此外，libpq前端-后端库所使用的任何默认连接设置和环境变量都将适用。

如果你的数据库集簇对于 template1 数据库有任何本地添加，要注意将pg_restore的输出载入到一个真正的空数据库。否则你很可能由于以增加对象的重复定义而得到错误。要创建一个不带任何本地添加的空数据库，从 template0 而不是 template1 复制它，例如：

下面将详细介绍pg_restore的局限性。

一旦完成恢复，应该在每一个被恢复的表上运行 ANALYZE，这样优化器能得到有用的统计信息。

假设我们已经以自定义格式转储了一个叫做 mydb 的数据库：

要删除该数据库并且从转储中重新创建它：

-d 开关中提到的数据库可以是任何已经存在于集簇中的数据库，pg_restore只会用它来为 mydb 发出 CREATE DATABASE 命令。通过 -C，数据总是会被恢复到出现在归档文件的数据库名中。

要把转储重新载入到一个名为 newdb 的新数据库中：

注意我们不使用 -C，而是直接连接到要恢复到其中的数据库。还要注意我们是从 template0 而不是 template1 创建了该数据库，以保证它最初是空的。

要对数据库项重排序，首先需要转储归档的表内容：

列表文件由一个头部和一些行组成，这些行每一个都用于一个项，例如：

分号表示开始一段注释，行首的数字表明了分配给每个项的内部归档 ID。

文件中的行可以被注释掉、删除以及重排序。例如：

把这样一个文件作为pg_restore的输入将会只恢复项 10 和 6，并且先恢复 10 再恢复 6。

pg_verifybackup [option…​]

pg_verifybackup 接受以下命令行参数：

检测到备份问题后立即退出。 如果没有指定这个选项，pg_verifybackup 将在检测到问题后继续检查备份，并将检测到的所有问题报告为错误。

在将备份中实际存在的数据文件列表与 backup_manifest 文件中列出的数据文件列表进行比较时，忽略指定的文件或目录，该文件或目录应表示为相对路径名。如果指定了目录，则此选项会影响以该位置为根的整个子树。 如果相对路径名与指定的路径名匹配，有关额外文件、丢失文件、文件大小差异或校验和不匹配的投诉将被抑制。 可以多次指定此选项。

使用指定路径的清单文件，而不是位于备份目录根目录中的清单文件。

不要试图解析从该备份恢复所需的预写式日志数据。

成功验证备份后不要打印任何内容。

不要验证数据文件校验和。但仍检查是否存在文件以及这些文件的大小。这样将会快得多，因为文件本身不需要读取。

尝试解析存储在指定目录中的 WAL 文件，而不是 pg_wal。 如果备份存储在与WAL存档不同的位置，则这可能很有用。

其他选项也可用：

打印 pg_verifybackup 版本并退出。

显示有关pg_verifybackup命令行参数的帮助，然后退出。

要在 mydbserver 上创建服务器的基本备份并验证备份的完整性：

要在 mydbserver 上创建服务器的基本备份，请将清单移动到备份目录之外的某个位置，并验证备份：

要在忽略手动添加到备份目录的文件的同时验证备份，并跳过校验和验证：

psql [option…​] [dbname [username]]

把所有非空输入行按照它们被读入的形式打印到标准输出（不适用于交互式行读取）。这等效于把变量 ECHO 设置为 all。

切换到非对齐输出模式（默认输出模式是 对齐 的）。这等效于 \pset format unaligned。

把失败的 SQL 命令打印到标准错误输出。这等效于把变量 ECHO 设置为 errors。

指定psql执行一个给定的命令字符串 command。这个选项可以重复多次并且以任何顺序与 -f 选项组合在一起。当 -c 或者 -f 被指定时，psql不会从标准输入读取命令，直到它处理完序列中所有的 -c 和 -f 选项之后终止。command 必须是一个服务器完全可解析的命令字符串（即不包含psql相关的特性）或者单个反斜线命令。因此不能在一个 -c 选项中混合SQL和psql元命令。要那样做，可以使用多个 -c 选项或者把字符串用管道输送到psql中，例如： psql -c '\x' -c 'SELECT * FROM foo;' ` 或者 `echo '\x \\ SELECT * FROM foo;' | psql ` （ `\\ 是分隔符元命令）。每一个被传递给 -c 的SQL命令字符串会被当做一个单独的请求发送给服务器。因此，即便该字符串包括多个SQL命令，服务器也会把它当做一个事务来执行，除非在该字符串中有显式的 BEGIN / COMMIT 命令把它划分成多个事务。此外，psql只会打印出该字符串中最后一个SQL命令的结果。这和从文件中读取同一字符串或者把同一字符串传给psql的标准输出时的行为不同，因为那两种情况下psql会独立地发送每一个SQL命令。由于这种行为，把多于一个SQL命令放在 -c 字符串中通常会得到意料之外的结果。最好使用多个 -c 命令或者把多个命令输送给psql的标准输入，按照上文所说的使用echo或者通过一个shell，例如： `psql <<EOF \x SELECT * FROM foo; EOF `

切换到CSV（逗号分隔值）输出模式。 这相当于 \pset format csv。

指定要连接的数据库的名称。这等效于指定 dbname 为命令行上的第一个非选项参数。dbname 可以是 连接字符串。 如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。

也把发送到服务器的所有 SQL 命令复制到标准输出。这等效于把变量 ECHO 设置为 queries。

回显 \d 以及其他反斜线命令生成的实际查询。可以用它来学习psql的内部操作。这等效于把变量 ECHO_HIDDEN 设置为 on。

从文件 filename 而不是标准输入中读取命令。这个选项可以被重复多次，也可以以任意顺序与 -c 选项组合。当 -c 或者 -f 被指定时，psql不会从标准输入读取命令，直到它处理完序列中所有的 -c 和 -f 选项之后终止。除此以外，这个选项很大程度上等价于元命令 \i。如果 filename 是 - （连字符），那么会读取标准输入直到遇见一个 EOF 指示或者 \q 元命令。这种方式可以用把自多个文件的输入组合成一种交互式输入。不过注意在这种情况下不会使用 Readline（很像指定了 -n 的情况）。使用这个选项与 psql < filename 有细微的不同。通常，两种形式都可以做到我们所期望的，但是使用 -f 启用了一些好的特性，例如带有行号的错误消息。使用这个选项还有一丝机会可以降低启动开销。在另一方面，使用shell输入重定向的变体（理论上）保证会得到与手工输入时相同的输出。

使用 separator 作为非对齐输出的域分隔符。这等效于 \pset fieldsep 或者 \f。

指定运行服务器的机器的主机名。如果这个值由一个斜线开始，它会被用作 Unix 域套接字的目录。

切换到HTML输出模式。这等效于 \pset format html 或者 \H 命令。

列出所有可用的数据库，然后退出。其他非连接选项会被忽略。这与元命令 \list 类似。在使用这个选项时，psql将连接到数据库 postgres，除非在命令行上提及一个不同的数据（选项 -d 或非选项参数，可能是通过一个服务项，但不能通过一个环境变量）。

除了把所有查询输出写到普通输出目标之外，还写到文件 filename 中。

不使用Readline做行编辑并且不使用命令历史。在剪切和粘贴时，关掉 Tab 展开会有所帮助。

把所有查询输出放到文件 filename 中。这等效于命令 \o。

指定服务器用于监听连接的 TCP 端口或者本地 Unix 域套接字文件扩展。默认是 PGPORT 环境变量的值，如果没有设置，则默认为编译时指定的端口号（通常是5432）。

以 \pset 的形式指定打印选项。注意，这里你必须用一个等号而不是空格来分隔名称和值。例如，要设置输出格式为LaTeX，应该写成 -P format=latex。

指定psql应该安静地工作。默认情况下，它会打印出欢迎消息以及多种输出。如果使用了这个选项，以上那些就都不会输出。在使用 -c 选项时，配合这个选项很有用。这等效于设置变量 QUIET 为 on。

把 separator 用作非对齐输出的记录分隔符。这等效于 \pset recordsep 命令。

运行在单步模式中。这意味着在每个命令被发送给服务器之前都会提示用户一个可以取消执行的选项。使用这个选项可以调试脚本。

运行在单行模式中，其中新行会终止一个 SQL 命令，就像分号的作用一样。注意这种模式被提供给那些坚持使用它的用户，但是并不一定要使用它。特别地，如果在一行中混合了SQL和元命令，那对于没有经的用户来说，它们的执行顺序可能不总是那么清晰。

关闭打印列名和结果行计数页脚等。这等效于 \t 或者 \pset tuples_only 命令。

指定要替换HTML table 标签的选项。详见 \pset tableattr。

作为用户 username 而不是默认用户连接到数据库（当然，你必须具有这样做的权限）。

执行一次变量赋值，和 \set 元命令相似。注意你必须在命令行上用等号分隔名字和值（如果有）。要重置一个变量，去掉等号就行。要把一个变量置为空值，使用等号但是去掉值。这些赋值在命令行处理期间被完成，因此反映连接状态的变量将在稍后被覆盖。

打印psql版本并且退出。

从不发出一个口令提示。如果服务器要求口令认证并且口令不能从其他来源（例如一个 .pgpass 文件）获得，那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。注意这个选项将对整个会话保持设置，并且因此它会影响元命令 \connect 的使用，就像初始的连接尝试那样。

强制psql在连接到一个数据库之前提示要求一个口令，即使口令不会被使用。如果服务器需要口令认证并且口令不能从其他来源获得，例如 .pgpass 文件，psql 在任何情况下都会提示输入口令。 然而，psql 将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。注意这个选项将对整个会话保持设置，并且因此它会影响元命令 \connect 的使用，就像初始的连接尝试那样。

打开扩展表格式模式。这等效于 \x 或者 \pset expanded 命令。

不读取启动文件（要么是系统范围的 psqlrc 文件，要么是用户的 ~/.psqlrc 文件）。

设置非对齐输出的域分隔符为零字节。这等效于 \pset fieldsep_zero。

设置非对齐输出的记录分隔符为零字节。例如，这对与 xargs -0 配合有关。这等效于 \pset recordsep_zero。

这个选项只能被用于与一个或者多个 -c 以及/或者 -f 选项组合。它会让psql在第一个上述选项之前发出一条 BEGIN 命令并且在最后一个上述选项之后发出一条 COMMIT 命令，这样就把所有的命令都包裹在一个事务中。这个选项可以保证要么所有的命令都成功地完成，要么不应用任何更改。如果命令本身包含 BEGIN 、 COMMIT 或者 ROLLBACK，这个选项将不会得到想要的效果。还有，如果当个命令不能在一个事务块中执行，指定这个选项将导致整个事务失败。

显示有关psql的帮助并且退出。可选的 topic 参数（默认为 options ）选择要解释哪一部分的psql： commands 描述psql的反斜线命令； options 描述可以被传递给psql的命令行选项；而 variables 则显示有关psql配置变量的帮助。

如果psql正常完成，它会向 shell 返回 0。如果它自身发生一个致命错误（例如内存用完、找不到文件），它会返回 1。如果到服务器的连接出问题并且事务不是交互式的，它会返回 2。如果在脚本中发生错误，它会返回 3 并且变量 ON_ERROR_STOP 会被设置。

如果 \pset columns 为零，这个环境变量控制用于 wrapped 格式的宽度以及用来确定是否输出需要用到分页器或者切换到扩展自动模式中的垂直格式的宽度。

默认连接参数。

规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

\e、 \ef 以及 \ev 命令所使用的编辑器。会按照列出的顺序检查这些变量，第一个被设置的将被使用。如果都没有被设置，默认是使用Unix系统上的 vi 或者Windows系统上的 notepad.exe。

当 \e、 \ef 或者 \ev 带有一个行号参数时，这个变量指定用于传递起始行号给用户编辑器的命令行参数。对于Emacs或者vi之类的编辑器，这个变量是一个加号。如果需要在选项名称和行号之间有空格，可以在该变量的值中包括一个结尾的空格。例如： PSQL_EDITOR_LINENUMBER_ARG='+' PSQL_EDITOR_LINENUMBER_ARG='--line ' ` 在 Unix 系统上默认是 `+ （对应于默认编辑器 vi ，且对很多其他常见编辑器可用）。在 Windows 系统上没有默认值。

命令历史文件的替代位置。波浪线（ ~ ）扩展会被执行。

如果一个查询的结果在屏幕上放不下，它们会通过这个命令分页显示。典型的值是 more 或 less。通过把 PSQL_PAGER 或 PAGER 设置为空字符串可以禁用分页器的使用，调整 \pset 命令与分页器相关的选项也能达到同样的效果。会按照列出的顺序检查这些变量，第一个被设置的将被使用。如果都没有被设置，则大部分平台上默认使用 more，但在Cygwin上使用 less。

用户的 .psqlrc 文件的替代位置。波浪线（ ~ ）扩展会被执行。

被 \! 命令执行的命令。

存储临时文件的目录。默认是 /tmp 。

和大部分其他IvorySQL工具一样，这个工具也使用libpq所支持的环境变量。

如果没有 -X 选项，在连接到数据库后但在接收正常的命令之前，psql会尝试依次从系统级的启动文件（ psqlrc ）和用户的个人启动文件（ ~/.psqlrc ）中读取并且执行命令。这些文件可以被用来设置客户端或者服务器，通常是一些 \set 和 SET 命令。系统级的启动文件是 psqlrc，它应该在安装好的IvorySQL的“系统配置”目录中，最可靠的定位方法是运行 pg_config --sysconfdir 。默认情况下，这个目录将是 ../etc/ （相对于包含IvorySQL可执行文件的目录）。可以通过 PGSYSCONFDIR 环境变量显式地设置这个目录的名称。用户个人的启动文件是 .psqlrc，它应该在调用用户的主目录中。在 Windows 上，由于没有用户主目录的概念，个人的启动文件是 %APPDATA%\postgresql\psqlrc.conf 。用户启动文件的位置可以通过 PSQLRC 环境变量设置。系统级和用户个人的启动文件都可以弄成是针对特定psql版本的，方法是在文件名后面加上一个横线以及IvorySQL的主、次版本号，版本最为匹配的文件会优先于不那么匹配的文件读入。

命令行历史被存储在文件 ~/.psql_history 中，或者是 Windows 的文件 %APPDATA%\postgresql\psql_history 中。历史文件的位置可以通过 HISTFILE psql变量或者 PSQL_HISTORY 环境变量明确的设置。

如果你想用psql连接到多个具有不同主版本的服务器，推荐使用最新版本的psql。或者，你可以为每一个主版本保留一份psql拷贝，并且针对相应的服务器使用匹配的版本。但实际上，这种额外的麻烦是不必要的。

第一个例子展示了如何如何跨越多行输入一个命令。注意提示符的改变：

现在再看看表定义：

现在我们把提示符改一改：

假定已经用数据填充了这个表并且想看看其中的数据：

你可以用 \pset 命令以不同的方式显示表：

或者使用短命令：

此外，可以使用 \g 为一个查询设置这些输出格式选项：

这是一个示例，用 \df 命令以发现名称匹配 int*pl 并且第二参数是 bigint 类型的函数:

如果需要，可以用 \crosstabview 命令以交叉表的形式显示查询结果：

这第二个例子展示了表的“乘法”（连接），行按照序号降序排序且列按照独立的、升序的方式排序。

reindexdb [connection-option…​] [option…​] [ -S | --schema schema ] …​ [ -t | --table table ] …​ [ -i | --index index ] …​ [dbname]

reindexdb [connection-option…​] [option…​] -s | --system [dbname]

reindexdb接受下列命令行参数：

当 -a / --all 未使用时，指定要重新索引的数据库的名称。 如果未指定，则从环境变量 PGDATABASE 中读取数据库名称。 如果未设置，则使用为连接指定的用户名。 dbname 可以是 连接字符串。 如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。

回显reindexdb生成并发送到服务器的命令。

通过同时运行 njobs 命令并行执行 reindex 命令。 此选项可能会减少处理时间，但也会增加数据库服务器上的负载。reindexdb将打开到数据库的 njobs 连接，因此请确保 max_connections 设置足够高，可以容纳所有连接。请注意，此选项与 --index 和 --system 选项不兼容。

不显示进度消息。

仅索引数据库的系统目录。

只对 schema 重建索引。 通过写多个 -S 开关可以指定多个要重建索引的模式。

只索引 table。可以通过写多个 -t 开关来重索引多个表。

指定要重建索引的表空间。 （这个名字以双引号标识符来处理。）

在处理时打印详细信息。

打印reindexdb版本并退出。

显示有关reindexdb命令行参数的帮助并退出。

reindexdb也接受下列命令行参数用于连接参数：

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。

要作为哪个用户连接。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制reindexdb在连接到一个数据库之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，reindexdb将自动提示要求一个口令。但是，reindexdb将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

当使用 -a / --all 时，指定要连接到的数据库名称以发现应重新索引哪些数据库。 如果未指定，将使用 postgres 数据库， 如果不存在，将使用 template1 。 这可以是 连接字符串。 如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。 此外，在连接到其他数据库时，将重新使用除数据库名称本身之外的连接字符串参数。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

在有困难时，可以在 REINDEX和 psql 中找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

reindexdb可能需要多次连接到IvorySQL服务器，每一次都会询问一个口令。在这种情况下使用一个 ~/.pgpass 文件会更方便。

要重索引数据库 test：

要重索引名为 abcd 的数据库中的表 foo 和索引 bar：

vacuumdb [connection-option…​] [option…​] [ -t | --table table [( column [,…​] )] ] …​ [dbname]

vacuumdb接受下列命令行参数：

清理所有数据库。

指定要清理或分析的数据库的名称，当不使用 -a / --all`时。 如果未指定，则从环境变量 `PGDATABASE 中读取数据库名称。 如果环境变量也没有设置，指定给该连接的用户名将用作数据库名。 dbname 可以是 connection string。 如果是这样，连接时的字符串参数将覆盖任何冲突的命令行选项。

根据可见性地图的内容禁用跳过页面。

回显vacuumdb生成并发送给服务器的命令。

执行“完全”清理。

强有力地“冻结”元组。

总是移除指向死元组的索引条目。注意这个选项仅在服务器运行IvorySQL12或更晚版本时有效。

通过同时运行 njobs 个命令来并行执行清理或者分析命令。这个选项可能会减少处理的时间， 但是它也会增加数据库服务器的负载。vacuumdb将开启 njobs 个到数据库的连接，因此请确认你的 max_connections 设置足够高以容纳所有的连接。注意如果某些系统目录被并行处理，使用这种模式加上 -f（ FULL ）选项可能会导致 死锁失败。

仅在multixact ID 年龄至少为 mxid_age 的表上执行清空或分析命令。 此设置对于确定要处理的表的优先级比较有用，以防止multixact ID 回绕。对于此选项的用途，关系的multixact ID年龄是主关系及其关联的TOAST表的年龄中最大的，如果存在的话。 由于vacuumdb发出的命令在需要时还将处理TOAST表的关系，它无需单独考虑。

仅在事务ID 年龄至少为 xid_age 的表上执行清空或分析命令。 此设置对于确定要处理的表的优先级比较有用，以防止事务ID 回绕。对于此选项的用途，关系的事务ID年龄是主关系及其关联的TOAST表的年龄中最大的，如果存在的话。 由于vacuumdb发出的命令在需要时还将处理TOAST表的关系，它无需单独考虑。

不移除指向死元组的索引条目。

略过与要清理的表有关联的任何 TOAST 表。

不要在表的结尾截断空页面。

指定 parallel vacuum 的并发数量。 这允许清理利用多个 CPU 来处理索引。 请参见 VACUUM。

不显示进度消息。

跳过无法立即锁定以进行处理的关系。

只清理或分析 table。列名只能和 --analyze 或 --analyze-only 选项一起被指定。通过写多个 -t 开关可以清理多个表。提示如果你指定列，你可能必须转义来自 shell 的括号（见下面的例子）。

在处理期间打印详细信息。

打印vacuumdb版本并退出。

也计算优化器使用的统计信息。

只计算优化器使用的统计信息（不清理）。

与 --analyze-only 相似，只计算优化器使用的统计信息（不做清理）。 使用不同的配置设置运行分析的几个（目前是 3个）阶段以更快地产生可用的统计信息。这个选项对分析一个刚从转储恢复或者通过 pg_upgrade 得到的数据库有用。这个选项将尝试尽可能快地创建一些统计信息来让该数据库可用，然后在后续的阶段中产生完整的统计信息。

显示有关vacuumdb命令行参数的帮助并退出。

vacuumdb也接受下列命令行参数用于连接参数：

指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。

要作为哪个用户连接。

从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个 .pgpass 文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。

强制vacuumdb在连接到一个数据库之前提示要求一个口令。这个选项不是必不可少的，因为如果服务器要求口令认证，vacuumdb将自动提示要求一个口令。但是，vacuumdb将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用 -W 来避免额外的连接尝试。

当使用 -a / --all 时，指定要连接到的数据库名称以发现应该清理的数据库。 如果未指定，将使用 postgres 数据库，如果不存在，将使用 template1。 这可以是 connection string。 如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。 此外，在连接到其他数据库时，将重新使用除数据库名称本身之外的连接字符串参数。

默认连接参数

规定在诊断消息中是否使用颜色。可能的值为 always、 auto 和 never。

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

在有困难时，可以在 VACUUM 和 psql 中找潜在问题和错误消息的讨论。数据库服务器必须运行在目标主机上。同样，任何libpq前端库使用的默认连接设置和环境变量都将适用于此。

vacuumdb可能需要多次连接到IvorySQL服务器，每次都询问一个口令。在这种情况下有一个 ~/.pgpass 文件会很方便。

要清理数据库 test：

要清理和为优化器分析一个名为 bigdb 的数据库：

要清理在名为 xyzzy 的数据库中的一个表 foo，并且为优化器分析该表的 bar 列：

initdb [option…​] -D”> directory`

这个选项为本地用户指定在 pg_hba.conf 中使用的默认认证方法（ host 和`local` 行）。initdb 将使用指定的认证方法为非复制连接以及复制连接填充 pg_hba.conf 项。除非你信任你系统上的所有本地用户，不要使用 trust。为了安装方便，trust 是默认值。

这个选项为通过 TCP/IP 连接的本地用户指定在 pg_hba.conf 中使用的认证方法（ host 行）。

这个选项为通过 Unix 域套接字连接的本地用户指定在 pg_hba.conf 中使用的认证方法（ local 行）。

这个选项指定数据库集簇应该存放的目录。这是 initdb 要求的唯一信息，但是你可以通过设定 PGDATA 环境变量来避免书写它，这很方便因为之后数据库服务器（ postgres ）可以使用同一个变量来找到数据库目录。

选择模板数据库的编码。这也将是后来创建的任何数据库的默认编码，除非你覆盖它。默认值来自于区域，或者如果该值不起作用则为 SQL_ASCII。

允许与集簇拥有者同组的用户读取 initdb 创建的所有集簇文件。 Windows会忽略此选项，因为它不支持POSIX样式的组权限。

在数据页面上使用校验码来帮助检测 I/O 系统造成的损坏。 启用校验码将会引起显著的性能惩罚。 如果设置，则为所有对象计算校验和，在整个数据库中。 所有校验和失败都将报告在 pg_stat_database 视图。

为数据库集簇设置默认区域。如果这个选项没有被指定，该区域将从 initdb 所运行的环境中继承。

和 --locale 相似，但是只在指定的分类中设置区域。

等效于 --locale=C。

默认情况下，initdb 将等待所有文件被安全地写到磁盘。这个选项会导致 initdb 不等待就返回，这当然更快，但是也意味着一次后续的操作系统崩溃可能让数据目录损坏。通常，这个选项对测试有用，但是不应该在创建生产安装时使用。

默认情况下，initdb 将在输出的尾部写入如何启动集群的指令。 这个选项会导致那些指令被抛弃。 这主要由平台特定行为中封装 initdb 的工具来使用，那些指令有可能是错误的。

让 initdb 从一个文件读取数据库超级用户的口令。该文件的第一行被当作口令。

安全地把所有数据库文件写入到磁盘并退出。这不会执行任何正常的initdb操作。

设置默认的文本搜索配置。详见 default_text_search_config。

选择数据库超级用户的用户名。这个的默认值是实际运行 initdb 的用户的名称。超级用户的名字是什么真的不重要，但是你可以选择保留常用的名字postgres，即使操作系统的用户名不同。

让 initdb 提示要求为数据库超级用户给予一个口令。如果你没有计划使用口令认证，这就不重要。否则在你设置一个口令之前你就无法使用口令认证。

这个选项指定预写式日志会被存储在哪个目录中。

设置 WAL段尺寸，以兆字节为单位。这是WAL日志中每个文件的尺寸。默认的尺寸为16兆字节。该值必须位于2的1次幂和1024次幂（兆字节）之间。这个选项只能在初始化期间设置，并且之后不能更改。调整这个值来控制WAL日志传送或者归档可能会有用。此外，在有大量WAL的数据库中，每个目录中数量巨大的WAL文件可能会成为性能和管理问题。增加WAL文件尺寸将会降低WAL文件的数量。

其他较少使用的选项：

打印来自引导后端的调试输出以及普通大众不那么感兴趣的一些消息。引导后端被程序 initdb 用来创建目录表。这个选项会生成大量极端无聊的输出。

使用 debug_discard_caches=1 选项运行引导程序后端。 这需要很长时间并且只适用于深度调试。

指定 initdb 应从哪里寻找它的输入文件来初始化数据库集簇。这通常没有必要。如果你需要显式指定它们的位置，你应该被告知。

默认情况下，当 initdb 确定有一个错误阻止它完整地创建数据库集簇，它会移除在它发现无法完成任务之前创建的任何文件。这个选项会抑制这种整理并且对调试有用。

其他选项：

打印initdb版本并退出。

显示有关initdb命令行参数的帮助并退出。

指定数据库集簇应该被存放的目录，可以使用 -D 选项覆盖。

规定在诊断消息中是否使用颜色。可能的值为 always、 auto、 never。

指定创建的数据集簇的默认时区。值应该是一个完整的时区名称

和大部分其他IvorySQL工具相似，这个工具也使用libpq支持的环境变量。

initdb 可以通过 pg_ctl initdb 被调用。

pg_archivecleanup [option…​] archivelocation oldestkeptwalfile

pg_archivecleanup接受下列命令行参数：

在 stderr 上打印很多调试日志输出。

在 stdout 上打印将被移除的文件的名字（执行一次演习）。

打印pg_archivecleanup版本并退出。

提供一个扩展名，在决定所有的文件 是否应该被删除之前，将从文件名中剥离这个扩展名。这通常有助于清理已经 存储期间被压缩过并且被压缩程序增加了一个扩展名的归档。例如： -x .gz。

显示pg_archivecleanup命令行参数的帮助并退出。

环境变量 PG_COLOR 指定是否在诊断消息中使用颜色。 可能的值是 always, auto 和 never。

在 Linux 或者 Unix 系统上，你可能会用：

其中归档目录位于后备服务器上，这样 archive_command 通过 NFS 来访问它，但是文件对于后备服务器来说是本地的。这将会

pg_checksums [option…​] `datadir]

下列命令选项可用：

指定存储数据库集簇的目录。

检查校验和。如果未指定其它任何内容，这是缺省模式。

禁用校验和。