pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
vacuumdb — 对一个PostgreSQL数据库进行垃圾收集和分析
vacuumdb [connection-option...] [[--full] | [-f]] [[--analyze] | [-z]] [[--freeze] | [-F]] [--table | -t table [( column [,...] )] ] [dbname]
vacuumdb [connection-options...] [[--all] | [-a]] [[--full] | [-f]] [[--analyze] | [-z]] [[--freeze] | [-F]]
vacuumdb 是用于清理 PostgreSQL 数据库的工具。vacuumdb 还会生成供 PostgreSQL 查询优化器使用的内部统计信息。
vacuumdb是 SQL 命令VACUUM的包装器。通过该工具或通过访问服务器的其他方式来清理和分析数据库,在效果上没有区别。
vacuumdb接受下列命令行参数:
-a--all清理所有数据库。
[-d] dbname[--dbname] dbname指定要清理或分析的数据库名称。如果未指定并且没有使用 -a(或--all),则从环境变量 PGDATABASE 中读取数据库名。 如果该变量未设置,则使用连接时指定的用户名。
-e--echo回显 vacuumdb 生成并发送给服务器的命令。
-f--full执行“完全”清理。
-q--quiet不显示响应。
-t table [ (column [,...]) ]--table table [ (column [,...]) ]只清理或分析 table。列名只能与 --analyze 选项一起指定。
如果指定了列,你很可能需要在 shell 中转义括号。(见下面的示例。)
-v--verbose在处理过程中输出详细信息。
-z--analyze计算供优化器使用的统计信息。
vacuumdb还接受以下用于连接参数的命令行参数:
-h host--host host指定服务器运行所在机器的主机名。如果该值以斜杠开头,则将其用作 Unix 域套接字的目录。
-p port--port port指定服务器监听连接所用的 TCP 端口,或本地 Unix 域套接字文件扩展名。
-U username--username username连接时使用的用户名。
-W--password强制提示输入密码。
PGDATABASEPGHOSTPGPORTPGUSER默认连接参数
vacuumdb可能需要多次连接到PostgreSQL服务器,每次都要询问密码。在这种情况下,使用~/.pgpass文件会比较方便。更多信息见第 28.12 节。
清理数据库 test:
$vacuumdb test
清理并为优化器分析数据库 bigdb:
$vacuumdb --analyze bigdb
清理单个表 foo,它位于数据库 xyzzy 中,并为优化器分析该表的单列 bar:
$vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。