vacuumdb - 收集垃圾并且分析一个PostgreSQL 数据库

SYnopSIS

VACUUMdb [ connection-option...] [ --full | -f ] [ --verbose | -v ] [ --analyze | -z ] [ --table | -t table [ ( column [,...] ) ]] [ dbname]

VACUUMdb [ connection-options...] [ --all | -a ] [ --full | -f ] [ --verbose | -v ] [ --analyze | -z ]

DESCRIPTION 描述

VACUUMdb 是一个用于整理 POSTGResql @R_419_6948@的工具。 VACUUMdb 还将会生成用于 POSTGResql 查询优化器的内部统计数据。

VACUUMdb 是 sql 命令 VACUUM [VACUUM(7)] 的封装。 因此，用哪种方法清理数据库都没什么特别的。

OPTIONS 选项

VACUUMdb 接受下列命令行参数：

-a

--all

 清理所有@R_419_6948@。

[-d] dbname

[--dbname] dbname

 声明要被清理或分析的@R_419_6948@名称。 如果没有声明这个参数并且没有使用 -a（或 --all）， 那么从环境变量 PGDATABASE 里读取@R_419_6948@名。 如果那个也没有设置，则使用连接的用户名。

-e

--echo

 回显 VACUUMdb 生成的查询并且把它发送到服务器。

-f

--full

 执行"完全"清理．

-q

--quIEt

 不显示响应。

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

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

 只是清理或分析 table。 字段名称只是在与 --analyze 选项联合使用时才需要声明。

 

Tip: 提示: 如果你声明了要清理的字段，你可能不得不在 sHell 上逃逸圆括弧（见下面的例子）。

 

-v

--verbose

 在处理过程中打印详细信息。

-z

--analyze

 计算用于优化器的该@R_419_6948@的统计值。

 

VACUUMdb 还接受下面的命令行参数用于联接参数：

-h host

--host host

 声明运行服务器的机器的主机名。 如果主机名以斜扛开头，则它被用做到 Unix 域套接字的路径。

-p port

--port port

 声明服务器在侦听联接的 TCP 端口号或一个本地的 Unix 域套接字文件句柄。

-U username

--username username

 进行联接的用户名。

-W

--password

 强制口令输入提示。

 

ENVIRONMENT 环境

PGDATABASE

PGHOST

PGPORT

PGUSER

 缺省连接参数

DIAGNOSTICS 诊断

 如果出差错了。参阅 VACUUM [VACUUM(7)]  和 psql(1)  获取关于错误信息和可能问题的详细描述。 @R_419_6948@服务器必须在目标主机上运行。同时，前端库 libpq 使用的任何缺省连接设置和环境变量都适用。

NOTES 注意

VACUUMdb 可能需要与 POSTGResql 服务器连接若干次，每次都询问口令。在这种情况下，设立一个 $HOME/.pgpass 是比较方便的。参阅 Section 27.11 获取更多信息。

EXAMPLES 例子

 整理@R_419_6948@ test：

 

$ VACUUMdb test

 为优化器清理和分析一个名为 bigdb 的@R_419_6948@：

 

$ VACUUMdb --analyze bigdb

 为清理数据库xyzzy里表 foo， 并且为优化器分析列 bar：

 

$ VACUUMdb --analyze --verbose --table ‘foo(bar)‘ xyzzy