CLUSTERDB(1)

NAME
clusterdb - PostgreSQL データベースのクラスタ化

SYNOPSIS

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

説明

clusterdb は、PostgreSQL データベース内のテーブルを再クラスタ化するためのユーティリティです。 すでにクラスタ化されているテーブルを検索し、前回と同じインデックスを使用して再度クラスタ化します。 一度もクラスタ化されていないテーブルは処理されません。

clusterdb は、SQLコマンド CLUSTER [cluster(l)] のラッパです。 このユーティリティを使用しても、これ以外の方法でサーバにアクセスしてクラスタ化を行っても特別な違いはありません。

オプション

clusterdb では、下記のコマンドライン引数を指定できます。

-a

--all
    すべてのデータベースをクラスタ化します。

[-d] dbname

[--dbname] dbname
    クラスタ化するデータベースの名前を指定します。 データベース名が指定されておらず、-a (または --all) も使用されていない場合、データベース名は環境変数 PGDATABASE から読み取られます。 この変数も設定されていない場合は、接続のために指定されたユーザ名が使用されます。

-e

--echo
    clusterdb が生成し、サーバに送るコマンドをエコー表示します。

-q

--quiet
    応答を表示させないようにします。

-t table

--table table
    table のみをクラスタ化します。

clusterdb は更に、下記のコマンドライン引数を接続パラメータとして受けつけます。

-h host

--host host
    サーバが稼働しているマシンのホスト名を指定します。 この値がスラッシュから始まる場合、Unix ドメインソケット用のディレクトリとして使用されます。

-p port

--port port
    サーバが接続を監視する TCP ポートもしくは Unix ドメインソケットファイルの拡張子を指定します。

-U username

--username username
    接続するためのユーザ名を指定します。

-W

--password
    強制的にパスワードのプロンプトを表示します。

環境

PGDATABASE

PGHOST

PGPORT

PGUSER
    デフォルトの接続パラメータです。

診断

問題が発生した場合、潜在する問題とエラーメッセージについては CLUSTER [cluster(l)] と psql(1) を参照してください。 対象ホスト上でデータベースサーバが稼働していなければなりません。 また、また、libpq のフロントエンドライブラリの、あらゆるデフォルトの設定や環境変数が適用されます。

例

データベースtestをクラスタ化します。

$ clusterdb test

データベースxyzzy内の1つのテーブルfooをクラスタ化します。

$ clusterdb --table foo xyzzy

関連項目
CLUSTER [cluster(l)]