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