百科 / 命令行工具 / 客户端程序

clusterdb

当前查看 PostgreSQL 18。

中文定义与说明

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

查看完整中文手册与上下文。

说明

描述 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 文件，则连接尝试将失败。此选项可用于无人输入密码的批处理作业和脚本

手册中的可执行程序: clusterdb
程序版本: 18.6
参考清单: 客户端程序
选项定义组: 13

用法

clusterdb [ connection-option ...] [ option ...] [ --table | -t table ] ... [ dbname | -a | --all ]

手册中的选项

选项与参数	说明
-a --all	聚簇所有数据库。
-e --echo	回显 clusterdb 生成并发送到服务器的命令。
-q --quiet	不显示进度消息。
-t table --table= table	仅对 table 执行聚簇。可以通过多次指定 -t 选项来聚簇多个表。
-v --verbose	在处理过程中输出详细信息。
-V --version	打印 clusterdb 的版本并退出。
-? --help	显示有关 clusterdb 命令行参数的帮助信息，并退出。
-h host --host= host	指定服务器所在机器的主机名。如果该值以斜杠开头，则它会被用作 Unix 域套接字目录。
-p port --port= port	指定服务器监听连接所用的 TCP 端口，或本地 Unix 域套接字文件扩展名。
-U username --username= username	连接时使用的用户名。
-w --no-password	绝不提示输入密码。如果服务器要求密码认证，而又无法通过其他方式获得密码，例如 .pgpass 文件，则连接尝试将失败。此选项可用于无人输入密码的批处理作业和脚本。
-W --password	强制 clusterdb 在连接到数据库之前提示输入密码。
--maintenance-db= dbname	当使用 -a / --all 时，连接到该数据库以收集要聚簇的数据库列表。如果未指定，则使用 postgres 数据库；如果它不存在，则使用 template1 。这里也可以是一个连接字符串。如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。此外，在连接其他数据库时，除数据库名本身外的连接字符串参数也会被重用。

环境变量

变量	含义
PGDATABASE PGHOST PGPORT PGUSER	默认连接参数
PG_COLOR	指定诊断消息是否使用颜色。可选值为 always 、 auto 和 never 。

文档与源码

来源构建

版本: 18.6
构建: https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
来源指纹: ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8

版本比较

PostgreSQL 11 → 12: 属性变化。

以下差异保留原始字段名与英文源描述。

--- PostgreSQL 11
+++ PostgreSQL 12
@@ -3,6 +3,10 @@
     {
       "description": "Default connection parameters",
       "name": "PGDATABASE PGHOST PGPORT PGUSER"
+    },
+    {
+      "description": "Specifies whether to use color in diagnostic messages. Possible values are always , auto and never .",
+      "name": "PG_COLOR"
     }
   ],
   "options": [

比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。

快速链接