↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

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 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5
历史版本PostgreSQL 7.1 已于 2006 年 4 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

vacuumdb

vacuumdb — 清理并分析一个 Postgres 数据库

大纲

vacuumdb [connection-options...] [[-d] dbname] [[--analyze] | [-z]] [[--verbose] | [-v]] [--table 'table [( column [,...] )]' ]
vacuumdb [connection-options...] [[--all] | [-a]] [[--analyze] | [-z]] [[--verbose] | [-v]]

Inputs

vacuumdb 接受下列命令行参数:

-d dbname
--dbname dbname

指定要清理或分析的数据库名。

-z
--analyze

为优化器的使用计算数据库的统计信息。

-a
--alldb

清理所有数据库。

-v
--verbose

在处理过程中输出详细信息。

-t table [ (column [,...]) ]
--table table [ (column [,...]) ]

只清理或分析 table。列名只能与 --analyze 选项一起指定。

提示

如果你指定了要清理(vacuum)的列,可能需要向 shell 转义括号。

vacuumdb 还接受 下列用于连接参数的命令行参数:

-h host
--host host

指定 postmaster 所在机器的主机名。如果 host 以斜杠开头,它被用作 unix 域套接字的目录。

-p port
--port port

指定 postmaster 正在监听连接的 Internet TCP/IP 端口或本地 Unix 域套接字文件扩展名。

-U username
--username username

要连接使用的用户名。

-W
--password

强制口令提示。

-e
--echo

回显 vacuumdb 生成并发送给后端的命令。

-q
--quiet

不显示响应。

Outputs

VACUUM

一切正常。

vacuumdb: Vacuum failed.

出了问题。vacuumdb 只是一个包装脚本。关于错误消息和潜在问题的详细讨论,参见 VACUUM 和 psql。

Description

vacuumdb 是一个用于清理 Postgres 数据库的工具。vacuumdb 还会生成供 Postgres 查询优化器使用的内部统计信息。

vacuumdb 是一个外壳脚本包装,它通过 Postgres 的交互式终端 psql 调用后端命令 VACUUM 。通过这种方式清理数据库与其他方法没有实质差别。脚本必须能找到 psql,而且目标主机上必须有数据库服务器在运行。此外,适用于 psql 和 libpq 前端库的任何默认设置和环境变量也同样有效。

Usage

清理数据库 test:

$ vacuumdb test

要为优化器分析名为 bigdb 的数据库:

$ vacuumdb --analyze bigdb

要为优化器分析数据库 xyzzy 中表 foo 的单个列 bar:

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

提交更正

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