clusterdb

名前

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

概要

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

説明

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

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

オプション

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

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

診断

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

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

$ clusterdb test

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

$ clusterdb --table foo xyzzy

関連項目

CLUSTER