受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

clusterdb

clusterdb — 聚簇一个PostgreSQL数据库

Synopsis

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。 这里也可以是一个连接字符串。 如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。 此外,在连接其他数据库时,除数据库名本身外的连接字符串参数也会被重用。

环境

PGDATABASE
PGHOST
PGPORT
PGUSER #

默认连接参数

PG_COLOR #

指定是否在诊断消息中使用颜色。可取值为alwaysautonever

该工具和大多数其他PostgreSQL工具一样,也使用 libpq支持的环境变量(见Section 32.15)。

诊断

如果遇到问题,请参见CLUSTERpsql中 关于潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外, libpq前端库所使用的任何默认连接设置和环境变量都会生效。

示例

要聚簇数据库test

$ clusterdb test

要聚簇名为xyzzy的数据库中的单个表foo

$ clusterdb --table=foo xyzzy

参见

CLUSTER

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。