pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
vacuumdb — 清理并分析一个 PostgreSQL 数据库
vacuumdb [connection-option...] [option...] [ --table | -t table [( column [,...] )] ] [dbname]
vacuumdb [connection-option...] [option...] -a | --all
vacuumdb 是用于清理 PostgreSQL 数据库的工具。vacuumdb 还会生成供 PostgreSQL 查询优化器使用的内部统计信息。
vacuumdb是 SQL 命令VACUUM的包装器。通过该工具或通过访问服务器的其他方式来清理和分析数据库，在效果上没有区别。
vacuumdb接受下列命令行参数：
-a--all清理所有数据库。
[-d] dbname[--dbname=]dbname指定要清理或分析的数据库名称。如果未指定并且没有使用 -a（或--all），则从环境变量 PGDATABASE 中读取数据库名。 如果该变量未设置，则使用连接时指定的用户名。
-e--echo回显 vacuumdb 生成并发送给服务器的命令。
-f--full执行“完全”清理。
-F--freeze激进地“冻结”元组。
-q--quiet不显示进度消息。
-t table [ (column [,...]) ]--table=table [ (column [,...]) ]仅清理或分析 table。只有结合 --analyze 或 --analyze-only 选项时才能指定列名。
如果指定了列，你很可能需要在 shell 中转义括号。（见下面的示例。）
-v--verbose在处理过程中输出详细信息。
-V--version输出 vacuumdb 的版本并退出。
-z--analyze同时计算供优化器使用的统计信息。
-Z--analyze-only仅计算供优化器使用的统计信息（不执行清理）。
-?--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连接到该数据库，以发现还有哪些其他数据库需要清理。如果未指定， 将使用 postgres 数据库；若该数据库不存在，则使用 template1。
vacuumdb可能需要多次连接到PostgreSQL服务器，每次都要询问密码。在这种情况下，使用~/.pgpass文件会比较方便。更多信息见第 31.15 节。
清理数据库 test：
$vacuumdb test
清理并为优化器分析数据库 bigdb：
$vacuumdb --analyze bigdb
清理单个表 foo，它位于数据库 xyzzy 中，并为优化器分析该表的单列 bar：
$vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。