clusterdb

Name

clusterdb?--?群集一個(gè)PostgreSQL數(shù)據(jù)庫

Synopsis

clusterdb [connection-option...] [--verbose | -v] [--table | -t table ] [dbname]

clusterdb [connection-option...] [--verbose | -v] [--all | -a]

描述

clusterdb用于對PostgreSQL 數(shù)據(jù)庫中的表進(jìn)行重新群集。它尋找以前群集過的表，然后在上次用過的同一個(gè)索引上再次群集。它不會(huì)動(dòng)那些從未群集的表。

clusterdb是對SQL命令CLUSTER的封裝。使用這兩種方法對數(shù)據(jù)庫群集實(shí)際上沒有任何區(qū)別。

選項(xiàng)

clusterdb 接受下列命令行參數(shù)：

-a --all

對所有數(shù)據(jù)庫進(jìn)行群集

[-d] dbname [--dbname] dbname

聲明要群集的數(shù)據(jù)庫名字。如果沒有聲明這個(gè)并且沒有使用-a (或者 --all) ，那么數(shù)據(jù)庫名從環(huán)境變量PGDATABASE中讀取。如果這個(gè)環(huán)境變量也沒有設(shè)置，那么使用用于連接的用戶名。

-e --echo

回顯clusterdb生成并發(fā)送給服務(wù)器的命令

-q --quiet

不要顯示進(jìn)程消息。

不要顯示程序信息。

-t table --table table

只對table表進(jìn)行群集。

-v --verbose

在處理期間打印詳細(xì)信息。

-V --version

打印clusterdb版本并推出。

-? --help

Show help about clusterdb command line arguments, and exit. 顯示關(guān)于clusterdb命令行參數(shù)的幫助并退出。

clusterdb 還接受下列命令行參數(shù)獲取連接參數(shù)：

-h host --host host

指定服務(wù)器所在的主機(jī)。如果數(shù)值以斜杠開頭，那么就用作Unix域套接字的目錄。

-p port --port port

聲明服務(wù)器監(jiān)聽的TCP端口或者本地Unix域套接字文件的擴(kuò)展。

-U username --username username

進(jìn)行連接的用戶名。

-w --no-password

不設(shè)密碼提示。如果服務(wù)器需要密碼身份驗(yàn)證并且一個(gè)密碼是不能通過javascript:void(0) 其他方式（例如.pgpass文件）獲得的，此連接嘗試將會(huì) 時(shí)報(bào)。這個(gè)選項(xiàng)在批量作業(yè)和腳本中是有效的，目前沒有用戶能輸入一個(gè)密碼。

-W --password

在倆接到一個(gè)數(shù)據(jù)庫之前，強(qiáng)制clusterdb 提示密碼。

連接數(shù)據(jù)庫之前強(qiáng)制clusterdb提示口令。

This option is never essential, since clusterdb will automatically prompt for a password if the server demands password authentication. However, clusterdb will waste a connection attempt finding out that the server wants a password. In some cases it is worth typing -W to avoid the extra connection attempt. 這個(gè)選項(xiàng)從來不是最重要的，盡管若服務(wù)器要求密碼認(rèn)證， clusterdb將會(huì)自動(dòng)提示密碼。然而， clusterdb將會(huì)浪費(fèi)嘗試發(fā)現(xiàn)服務(wù)器需要密碼的嘗試。有時(shí)可以鍵入-W來避免避免額外的連接請求。

環(huán)境變量

PGDATABASE PGHOST PGPORT PGUSER: 缺省連接參數(shù)

This utility, like most other PostgreSQL utilities, also uses the environment variables supported by libpq (see Section 31.13). 這個(gè)性能，跟大多數(shù)其他PostgreSQL性能一樣，也是用libpq 支持的環(huán)境變量(參閱Section 31.13)。

診斷

出現(xiàn)困難的時(shí)候，參閱CLUSTER 和psql獲取有關(guān)可能的錯(cuò)誤和錯(cuò)誤信息的討論。數(shù)據(jù)庫服務(wù)器必須在目標(biāo)主機(jī)上運(yùn)行。同樣，任何缺省連接設(shè)置和libpq前端庫使用的環(huán)境變量都將得以應(yīng)用。

例子

對數(shù)據(jù)庫test進(jìn)行群集：

$ clusterdb test

對xyzzy數(shù)據(jù)庫里的foo表進(jìn)行集群：

$ clusterdb --table foo xyzzy

又見

CLUSTER

Previous article： Next article：