vacuumdb

Name

vacuumdb  --  Postgres データベースのゴミ掃除と解析を 行なう。

Synopsis

vacuumdb [ options ] [ --analyze | -z ]
    [ --alldb | -a ] [ --verbose | -v ]
    [ --table 'table [ ( column [,...] ) ]' ] [ [-d] dbname ]
  

入力

vacuumdb は、以下のコマンドライン引数を 受け付けます。

-d dbname, --dbname dbname

ゴミ掃除または解析の対象となるデータベース名を指定します。

-z, --analyze

オプティマイザで使用される、データベースの統計情報を計算します。

-a, --alldb

全てのデータベースのゴミ掃除を行ないます。

-v, --verbose

処理実行中に詳細な情報を表示します。

-t table [ (column [,...]) ], --table table [ (column [,...]) ]

table のみのゴミ 掃除または解析を行ないます。 列名は --analyze オプションがある場合にの み指定することができます。

Tip: 列名を指定した場合、括弧をシェルからエスケープしなければな りません。

vacuumdb は、また、以下の接続パラメータ用のコ マンドライン引数も受け付けます。

-h host, --host host

postmaster が動作しているマシンのホ スト名を指定します。

-p port, --port port

postmaster が接続を監視するインター ネット TCP/IP ポート、もしくは、ローカル Unix ドメインソケット ファイルの拡張子を指定します。

-U username, --username username

接続に使用するユーザ名。

-W, --password

強制的にパスワードの入力を促します。

-e, --echo

vacuumdb が生成し、バックエンドに送 信するコマンドを表示します。

-q, --quiet

応答を表示しません。

出力

VACUUM

正常終了。

vacuumdb: Vacuum failed.

何らかの失敗。 vacuumdb は単なるラッパスクリプトです。 エラーメッセージと潜在的な問題に関する詳細な説明については VACUUM 及び psql を参照して下 さい。

説明

vacuumdb は、 Postgres データベースのゴミ掃除を行なう ユーティリティです。 また、vacuumdb は Postgres の問い合わせオプティマイザで使 用される内部的な統計情報も生成します。

vacuumdb は、 Postgres の対話式端末プログラム psql を使用して、バッ クエンドコマンド VACUUM を実行するシェ ルスクリプトです。 このコマンドによるデータベースのゴミ清掃は、これ以外の方法によるもの と実質的な違いはありません。 psql コマンドはこのスクリプトから検索可能 でなければなりません。そして、データベースサーバが対象ホストで実行さ れている必要があります。 psql 及び libpq フロントエンドライブラリで使用可能なデフォルトの設定と環境変数も適用 されます。

使用法

test データベースのゴミ掃除を行なう:

$ vacuumdb test

オプティマイザのために、bigdb という名前のデータ ベースの解析を行なう:

$ vacuumdb --analyze bigdb

オプティマイザのために、xyzzy という名前のデータ ベース の foo テーブルのある 1 つの bar というカラムに対して解析を行なう:

$ vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy