vacuumdb — 清理并分析一个 PostgreSQL 数据库
vacuumdb [connection-option...] [option...] [ -t | --table table [( column [,...] )] ] ... [ dbname | -a | --all ]
vacuumdb [connection-option...] [option...] [ -n | --schema schema ] ... [ dbname | -a | --all ]
vacuumdb [connection-option...] [option...] [ -N | --exclude-schema schema ] ... [ dbname | -a | --all ]
vacuumdb 是用于清理 PostgreSQL 数据库的工具。vacuumdb 还会生成供 PostgreSQL 查询优化器使用的内部统计信息。
vacuumdb 是 SQL 命令 VACUUM 的包装器。 通过该工具或通过访问服务器的其他方式来清理和分析数据库，在效果上没有区别。
vacuumdb 接受下列命令行参数：
-a--all清理所有数据库。
--buffer-usage-limit size指定给定一次 缓冲区访问策略（Buffer Access Strategy） 环形缓冲区大小，供 vacuumdb 调用使用。这个大小用于计算将作为该策略一部分被重用的共享缓冲区数量。参见 VACUUM。
[-d] dbname[--dbname=]dbname当未使用 -a/--all 时，指定要清理或分析的数据库名称。 如果未指定，则从环境变量 PGDATABASE 中读取数据库名。如果该变量未设置， 则使用连接时指定的用户名。dbname 可以是 连接字符串。如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。
--disable-page-skipping禁止基于可见性映射内容跳过页面。
-e--echo回显 vacuumdb 生成并发送给服务器的命令。
-f--full执行“完全”清理。
-F--freeze积极地“冻结”元组。
--force-index-cleanup始终删除指向死元组的索引条目。
-j njobs--jobs=njobs通过同时运行 njobs 条命令，并行执行清理或分析命令。 该选项可能会缩短处理时间，但也会增加数据库服务器上的负载。
vacuumdb 将打开 njobs 个到数据库的连接，因此请确保 max_connections 的设置足够高，能够容纳所有这些连接。
注意，如果将此模式与 -f（FULL）选项一起使用， 某些系统目录被并行处理时可能会发生死锁失败。
--min-mxid-age mxid_age仅对 multixact ID 年龄至少为 mxid_age 的表执行清理或分析命令。此设置可用于优先处理表，以防止 multixact ID 回卷 （见 Section 24.1.5.1）。
就此选项而言，一个关系的 multixact ID 年龄，是其主关系及其关联的 TOAST 表（如果存在）年龄中的较大者。由于 vacuumdb 发出的命令在必要时也会处理该关系的 TOAST 表，因此无需单独考虑它。
--min-xid-age xid_age仅对事务 ID 年龄至少为 xid_age 的表执行清理或分析命令。 此设置可用于优先处理表，以防止事务 ID 回卷（见 Section 24.1.5）。
就此选项而言，一个关系的事务 ID 年龄，是其主关系及其关联的 TOAST 表（如果存在）年龄中的较大者。由于 vacuumdb 发出的命令在必要时也会处理该关系的 TOAST 表，因此无需单独考虑它。
--missing-stats-only仅分析那些在列、索引表达式或扩展统计信息对象上缺少统计信息的关系。与 --analyze-in-stages 一起使用时，此选项可防止 vacuumdb 临时用按较低统计目标生成的统计信息替换现有统计信息， 从而避免查询优化器短暂地作出更差的选择。
此选项只能与 --analyze-only 或 --analyze-in-stages 配合使用。
注意，--missing-stats-only 要求拥有 SELECT 权限，以访问 pg_statistic 和 pg_statistic_ext_data， 而这些权限默认只授予超级用户。
-n schema--schema=schema仅清理或分析 schema 中的所有表。 可以通过多次指定 -n 来清理多个模式。
-N schema--exclude-schema=schema不清理或分析 schema 中的任何表。 可以通过多次指定 -N 来排除多个模式。
--no-index-cleanup不删除指向死元组的索引条目。
--no-process-main跳过主关系。
--no-process-toast如果有，跳过与待清理表关联的 TOAST 表。
--no-truncate不截断表末尾的空页。
-P parallel_workers--parallel=parallel_workers指定并行清理的并行工作进程数量。这样可以让清理利用多个 CPU 处理索引。 参见 VACUUM。
-q--quiet不显示进度消息。
--skip-locked跳过那些无法立即加锁并进行处理的关系。
-t table [ (column [,...]) ]--table=table [ (column [,...]) ]仅清理或分析 table。 只有与 --analyze 或 --analyze-only 选项一起使用时， 才能指定列名。可以通过多次指定 -t 来清理多个表。
如果指定了列，你很可能需要在 shell 中转义括号。（见下面的示例。）
-v--verbose在处理过程中输出详细信息。
-V--version输出 vacuumdb 的版本并退出。
-z--analyze同时计算供优化器使用的统计信息。
-Z--analyze-only仅计算供优化器使用的统计信息（不执行清理）。
--analyze-in-stages类似 --analyze-only，仅计算供优化器使用的统计信息（不执行清理）。 该选项会运行三个阶段的分析；第一阶段使用尽可能低的统计目标 （见 default_statistics_target），以便更快地生成可用统计信息， 随后的阶段再构建完整统计信息。
此选项仅在分析当前没有统计信息，或现有统计信息完全错误的数据库时才有用，例如数据库是 从恢复出的转储中重新填充，或是通过 pg_upgrade 新建得到的。 注意，在已有统计信息的数据库上使用此选项，可能会因为早期阶段采用较低统计目标， 导致查询优化器的选择暂时变差。
-?--help显示 vacuumdb 命令行参数的帮助并退出。
vacuumdb 还接受下列用于连接参数的命令行参数：
-h host--host=host指定服务器所在机器的主机名。如果该值以斜杠开头，则它会被用作 Unix 域套接字目录。
-p port--port=port指定服务器监听连接所用的 TCP 端口，或本地 Unix 域套接字文件扩展名。
-U username--username=username连接时使用的用户名。
-w--no-password绝不提示输入密码。如果服务器要求密码认证，而又无法通过其他方式获得密码，例如 .pgpass 文件，则连接尝试将失败。此选项可用于无人输入密码的批处理作业和脚本。
-W--password强制 vacuumdb 在连接数据库之前提示输入密码。
这个选项绝非必需，因为如果服务器要求密码认证， vacuumdb 会自动提示输入密码。不过， vacuumdb 会先浪费一次连接尝试，才得知服务器需要密码。 在某些情况下，输入 -W 以避免这次额外的连接尝试是值得的。
--maintenance-db=dbname当使用 -a/--all 时，连接到该数据库以收集要清理的数据库列表。 如果未指定，则使用 postgres 数据库；若该数据库不存在，则使用 template1。这可以是一个 连接字符串。如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。 此外，除数据库名本身外，连接字符串中的其他参数在连接到其他数据库时也会被复用。
PGDATABASEPGHOSTPGPORTPGUSER默认连接参数
PG_COLOR指定是否在诊断消息中使用颜色。可选值为 always、auto 和 never。
与大多数其他 PostgreSQL 工具一样，此工具也使用 libpq 支持的环境变量（见 Section 32.15）。
清理数据库 test：
$vacuumdb test
清理并分析名为 bigdb 的数据库，以供优化器使用：
$vacuumdb --analyze bigdb
清理名为 xyzzy 的数据库中的单个表 foo， 并为优化器分析该表中的单个列 bar：
$vacuumdb --analyze --verbose --table='foo(bar)' xyzzy
清理名为 xyzzy 的数据库中 foo 和 bar 模式内的所有表：
$vacuumdb --schema='foo' --schema='bar' xyzzy
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明，请使用此表单来报告文档问题。