clusterdb
clusterdb — 聚簇一个 PostgreSQL 数据库
大纲
clusterdb [connection-option...] [ --verbose | -v ]
[
--table | -t
table
]
... [dbname]
clusterdb [connection-option...] [ --verbose | -v ] --all | -a
描述
clusterdb 是一个用于重新聚簇 PostgreSQL 数据库中各表的工具。它会找出此前已经聚簇过的表,并按照上次使用的同一索引再次对其进行聚簇。从未聚簇过的表不会受到影响。
clusterdb 是 SQL 命令 CLUSTER 的一个包装器。使用该工具聚簇数据库,与使用其他访问服务器的方法聚簇数据库,并没有实质区别。
选项
clusterdb 接受下列命令行参数:
-a--all#聚簇所有数据库。
[-d]dbname[--dbname=]#dbname当未使用
-a/--all时,指定要聚簇的数据库名。如果未指定,则从环境变量PGDATABASE读取数据库名。如果该环境变量也未设置,则使用为该连接指定的用户名作为数据库名。dbname可以是一个连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。-e--echo#回显 clusterdb 生成并发送到服务器的命令。
-q--quiet#不显示进度消息。
-ttable--table=#table仅对
table执行聚簇。可以通过多次指定-t选项来聚簇多个表。-v--verbose#在处理过程中输出详细信息。
-V--version#打印 clusterdb 的版本并退出。
-?--help#显示有关 clusterdb 命令行参数的帮助信息,并退出。
clusterdb 还接受以下用于连接参数的命令行参数:
-hhost--host=#host指定服务器所在机器的主机名。如果该值以斜杠开头,则它会被用作 Unix 域套接字目录。
-pport--port=#port指定服务器监听连接所用的 TCP 端口,或本地 Unix 域套接字文件扩展名。
-Uusername--username=#username连接时使用的用户名。
-w--no-password#绝不提示输入密码。如果服务器要求密码认证,而又无法通过其他方式获得密码,例如
.pgpass文件,则连接尝试将失败。此选项可用于无人输入密码的批处理作业和脚本。-W--password#强制 clusterdb 在连接到数据库之前提示输入密码。
这个选项并非必不可少,因为如果服务器要求密码认证,clusterdb 会自动提示输入密码。不过,clusterdb 会浪费一次连接尝试,才知道服务器需要密码。在某些情况下,为了避免这次额外的连接尝试,提前指定
-W是值得的。--maintenance-db=#dbname当使用
-a/--all时,连接到该数据库以收集要聚簇的数据库列表。如果未指定,则使用postgres数据库;如果它不存在,则使用template1。这里也可以是一个连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。此外,在连接其他数据库时,除数据库名本身外的连接字符串参数也会被重用。
环境
与大多数其他 PostgreSQL 工具一样,此工具也使用 libpq 支持的环境变量(见第 34.15 节)。
示例
要聚簇数据库 test:
$clusterdb test
要聚簇名为 xyzzy 的数据库中的单个表 foo:
$clusterdb --table=foo xyzzy
另见
CLUSTER报告文档问题
阅读 上游文档. 通过 PostgreSQL 文档反馈表单.