vacuumdb
vacuumdb — 对一个 PostgreSQL 数据库进行垃圾收集和分析
大纲
vacuumdb [connection-options...] [[--full] | [-f]] [[--verbose] | [-v]] [[--analyze] | [-z]] [--table | -t 'table
[( column [,...] )]'
] [dbname]vacuumdb [connection-options...] [[--all] | [-a]] [[--full] | [-f]] [[--verbose] | [-v]] [[--analyze] | [-z]]
描述
vacuumdb 是用于清理 PostgreSQL 数据库的工具。vacuumdb 还会生成供 PostgreSQL 查询优化器使用的内部统计信息。
vacuumdb 是一个外壳脚本包装,它通过 PostgreSQL 的交互式终端psql调用后端命令VACUUM。通过这种方式清理数据库与其他方法没有实质差别。脚本必须能找到 psql,而且目标主机上必须有数据库服务器在运行。此外,适用于 psql 和 libpq 前端库的任何默认设置和环境变量也同样有效。
vacuumdb
可能需要多次连接
PostgreSQL
服务器,每次都要询问口令。这种情况下准备一个
$HOME/.pgpass
文件会很方便。
选项
vacuumdb接受下列命令行参数:
[-d]dbname[--dbname]dbname指定要清理或分析的数据库名称。如果未指定并且没有使用
-a(或--all),则从环境变量PGDATABASE中读取数据库名。如果该变量未设置,则使用连接时指定的用户名。-a--all清理所有数据库。
-e--echo回显 vacuumdb 生成并发送给服务器的命令。
-f--full执行“完全”清理。
-q--quiet不显示响应。
-ttable[ (column[,...]) ]--tabletable[ (column[,...]) ]只清理或分析
table。列名只能与--analyze选项一起指定。提示
如果你指定了要清理(vacuum)的列,可能需要向 shell 转义括号。
-v--verbose在处理过程中输出详细信息。
-z--analyze同时计算供优化器使用的统计信息。
vacuumdb还接受下列用于连接参数的命令行参数:
-hhost--hosthost指定服务器所在机器的主机名。如果 host 以斜杠开头,它被用作 Unix 域套接字的目录。
-pport--portport指定服务器正在监听连接的 Internet TCP/IP 端口或本地 Unix 域套接字文件扩展名
-Uusername--usernameusername连接时使用的用户名。
-W--password强制口令提示。
环境
PGDATABASEPGHOSTPGPORTPGUSER默认连接参数。
示例
清理数据库 test:
$vacuumdb test
清理并为优化器分析数据库 bigdb:
$vacuumdb --analyze bigdb
清理单个表 foo,它位于数据库 xyzzy 中,并为优化器分析该表的单列 bar:
$vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy