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
不显示进度消息。
-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
。这可以是 连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。此外,在连接到其他数据库时,将重新使用除数据库名称本身之外的连接字符串参数。
PGDATABASE
PGHOST
PGPORT
PGUSER
默认连接参数
PG_COLOR
指定是否在诊断消息中使用颜色。可能的值为 always
、auto
和 never
。
此实用程序与大多数其他 PostgreSQL 实用程序一样,也使用 libpq 支持的环境变量(请参见 第 34.15 节)。
要对数据库 test
进行群集
$
clusterdb test
要在名为 xyzzy
的数据库中对单个表 foo
进行群集
$
clusterdb --table=foo xyzzy