选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.0 已于 2015 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

vacuumdb

vacuumdb — garbage-collect and analyze a PostgreSQL database

大纲

vacuumdb [connection-option...] [[--full] | [-f]] [[--freeze] | [-F]] [[--verbose] | [-v]] [[--analyze] | [-z]] [[--analyze-only] | [-Z]] [--table | -t table [( column [,...] )] ] [dbname]

vacuumdb [connection-option...] [[--full] | [-f]] [[--freeze] | [-F]] [[--verbose] | [-v]] [[--analyze] | [-z]] [[--analyze-only] | [-Z]] [[--all] | [-a]]

描述

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 以避免这次额外的连接尝试是值得的。

环境

PGDATABASE
PGHOST
PGPORT
PGUSER

默认连接参数

与大多数其他 PostgreSQL 工具一样,此工具也使用 libpq 支持的环境变量(见 第 31.13 节)。

诊断

如遇困难,请参见 VACUUMpsql 中 关于潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外, libpq 前端库所使用的任何默认连接设置和环境变量也都会生效。

注解

vacuumdb可能需要多次连接到PostgreSQL服务器,每次都要询问密码。在这种情况下,使用~/.pgpass文件会比较方便。更多信息见第 31.14 节

示例

清理数据库 test

$ vacuumdb test

清理并为优化器分析数据库 bigdb

$ vacuumdb --analyze bigdb

清理单个表 foo,它位于数据库 xyzzy 中,并为优化器分析该表的单列 bar

$ vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy

另见

VACUUM

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。