PostgreSQL 8.0.0 文書
前のページ | 巻戻し |  | 早送り | 次のページ

# 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`

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

## 診断

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

## 例

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

    $ clusterdb test

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

    $ clusterdb --table foo xyzzy

## 関連項目

CLUSTER

前のページ | ホーム | 次のページ
PostgreSQL クライアントアプリケーション | 上に戻る | createdb