clusterdb — 对 PostgreSQL 数据库进行聚簇
clusterdb
[连接选项
...] [选项
...] [ --table
| -t
表
] ... [ 数据库名
| -a
| --all
]
clusterdb 是一个用于重新聚簇 PostgreSQL 数据库中表的工具。它会查找已聚簇的表,并使用上次使用的相同索引重新聚簇它们。从未聚簇过的表不受影响。
clusterdb 是 SQL 命令 CLUSTER 的封装。通过此工具与通过其他方法访问服务器进行数据库聚簇之间没有实际区别。
clusterdb 接受以下命令行参数:
-a
--all
聚簇所有数据库。
[-d] 数据库名
[--dbname=]数据库名
指定要聚簇的数据库名称,当未使用 -a
/--all
时。如果未指定,数据库名称将从环境变量 PGDATABASE
读取。如果该变量未设置,则使用连接指定的用户名。 数据库名
可以是 连接字符串。如果是,则连接字符串参数将覆盖任何冲突的命令行选项。
-e
--echo
回显 clusterdb 生成并发送到服务器的命令。
-q
--quiet
不显示进度消息。
-t table
--table=table
仅聚簇 表
。通过多次使用 -t
开关可以聚簇多个表。
-v
--verbose
在处理过程中显示详细信息。
-V
--version
打印 clusterdb 版本并退出。
-?
--help
显示有关 clusterdb 命令行参数的帮助信息并退出。
clusterdb 还接受以下用于连接参数的命令行参数:
-h 主机
--host=主机
指定服务器运行所在计算机的主机名。如果值以斜杠开头,则用作 Unix 域套接字目录。
-p 端口
--port=端口
指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。
-U 用户名
--username=用户名
要连接的用户。:
-w
--no-password
绝不发出密码提示。如果服务器需要密码身份验证且密码不可用(例如通过 .pgpass
文件),则连接尝试将失败。此选项在没有用户在场输入密码的批处理作业和脚本中很有用。
-W
--password
强制 clusterdb 在连接到数据库之前提示输入密码。
此选项永远不是必需的,因为如果服务器要求密码认证,clusterdb 会自动提示输入密码。但是,clusterdb 会尝试连接一次,以发现服务器需要密码。在某些情况下,键入 -W
来避免额外的连接尝试是值得的。
--maintenance-db=数据库名
当使用 -a
/--all
时,连接到此数据库以收集要聚簇的数据库列表。如果未指定,将使用 postgres
数据库,如果该数据库不存在,将使用 template1
。这可以是一个 连接字符串。如果是,则连接字符串参数将覆盖任何冲突的命令行选项。此外,除数据库名称本身以外的连接字符串参数将在连接到其他数据库时重复使用。
PGDATABASE
PGHOST
PGPORT
PGUSER
默认连接参数
PG_COLOR
指定是否在诊断消息中使用颜色。可能的值为 always
、auto
和 never
。
此实用程序以及大多数其他 PostgreSQL 实用程序也使用 libpq 支持的环境变量(请参阅 第 32.15 节)。
聚簇数据库 test
$
clusterdb test
聚簇名为 xyzzy
的数据库中的单个表 foo
$
clusterdb --table=foo xyzzy
如果您在文档中发现任何不正确之处、与您对特定功能的体验不符之处,或需要进一步澄清之处,请使用 此表单 报告文档问题。