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 的一个包装。通过此实用程序和通过其他访问服务器方法对数据库执行 vacuum 和 analyze 操作在效果上没有区别。
vacuumdb 接受以下命令行参数
-a--all对所有数据库执行 Vacuum 操作。
--buffer-usage-limit size指定 缓冲区访问策略环形缓冲区大小以进行一次 vacuumdb 调用。此大小用于计算将作为此策略的一部分被重用的共享缓冲区的数量。参见 VACUUM。
[-d] dbname[--dbname=]dbname指定要清理或分析的数据库名称，在未使用 -a/--all 时。如果没有指定，则会从环境变量 PGDATABASE 中读取数据库名称。如果未设置该变量，则使用为连接指定的用户名。 dbname 可以是 连接字符串。如果是这样，连接字符串参数将覆盖所有冲突的命令行选项。
--disable-page-skipping禁用根据可见性映射的内容跳过页面。
-e--echo回显 vacuumdb 生成的命令并将其发送到服务器。
-f--full执行 “全” VACUUM。
-F--freeze激进地 “冻结” 元组。
--force-index-cleanup始终删除指向无效元组的索引条目。
-j njobs--jobs=njobs通过同时运行 njobs 个命令，并行执行 VACUUM 或 ANALYZE 命令。此选项可以减少处理时间，但也会增加数据库服务器的负载。
vacuumdb 将打开与数据库的 njobs 个连接，因此请确保您的 max_connections 设置足够高以容纳所有连接。
请注意，将此模式与 -f (FULL) 选项结合使用可能会导致死锁故障，因为某些系统目录被并行处理。
--min-mxid-age mxid_age仅对具有至少 mxid_age 的 multixact ID 年龄的表执行 VACUUM 或 ANALYZE 命令。此设置对于对表进行优先级处理以防止 multixact ID 环绕（请参阅 第 24.1.5.1 节）很有用。
对于此选项，关系的 multixact ID 年龄是主关系年纪最大的那个和它关联的TOAST表中更大的那个，如果存在。因为 vacuumdb 发出的命令还将在必要时处理关系的TOAST表，所以无需单独考虑它。
--min-xid-age xid_age仅对具有至少 xid_age 的事务 ID 年龄的表执行 VACUUM 或 ANALYZE 命令。此设置对于对表进行优先级处理以防止事务 ID 环绕（请参阅 第 24.1.5 节）很有用。
对于此选项，关系的事务 ID 年龄是主关系年纪最大的那个和它关联的TOAST表中更大的那个，如果存在。因为 vacuumdb 发出的命令还将在必要时处理关系的TOAST表，所以无需单独考虑它。
-n schema--schema=schema仅清理或分析schema中的所有表。可通过编写多个-n开关对多个模式进行 VACUUM。
-N schema--exclude-schema=schema不清理或分析schema中的任何表。可通过编写多个-N开关排除多个模式。
--no-index-cleanup不移除指向无效元组的索引条目。
--no-process-main跳过主关系。
--no-process-toast如果存在，则跳过与要进行 VACUUM 的表相关联的 TOAST 表。
--no-truncate不截断表末尾的空页。
-P parallel_workers--parallel=parallel_workers指定并行 VACUUM的并行工作程序数。这允许 VACUUM 利用多个 CPU 来处理索引。请参阅VACUUM。
-q--quiet不显示进度消息。
--skip-locked跳过无法立即锁定以进行处理的关系。
-t table [ (column [,...]) ]--table=table [ (column [,...]) ]仅清理或分析table。列名称只能与--analyze或--analyze-only选项结合使用。可通过编写多个-t开关对多个表进行 VACUUM。
如果您指定列，则可能必须从 Shell 中转义括号。（请参阅下面的示例。）
-v--verbose在处理期间打印详细信息。
-V--version打印vacuumdb版本并退出。
-z--analyze还计算统计信息以供优化器使用。
-Z--analyze-only仅计算优化器需要统计数据（不进行 vacuum）。
--analyze-in-stages仅计算优化器需要统计数据（不进行 vacuum），例如 --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 支持的环境变量（请参阅 第 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