無料スクリプト配布のPHP.TO   PHPの実用的なtips PHPマニュアル MySQLマニュアル Apacheマニュアル PostgreSQLマニュアル マニュアル検索    

reindexdb

名前

reindexdb --  PostgreSQL データベースのインデックスを再作成します。

概要

reindexdb [ connection-option ...] [ --table | -t table ] ... [ --index | -i index ] ... [ dbname ]

reindexdb [ connection-option ...] --all | -a

reindexdb [ connection-option ...] --system | -s [ dbname ]

説明

reindexdb は、 PostgreSQL データベース内のインデックスを再作成するユーティリティです。

reindexdb は、 REINDEX SQLコマンドのラッパです。 このユーティリティを使用しても他の方法でサーバにアクセスしても、データベースインデックスの再作成には実質的な違いはありません。

オプション

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

-a
--all

すべてのデータベースのインデックスを再作成します。

[ -d ] dbname
[ --dbname= ] dbname

インデックス再作成を行うデータベースの名前を指定します。 これが指定されず、かつ、 -a (または --all )も使用されていない場合、 PGDATABASE 環境変数からデータベース名が決まります。 これも設定されていない場合は、接続時に指定したユーザ名が使用されます。

-e
--echo

reindexdb が生成しサーバに送信したコマンドを表示します。

-i index
--index= index

index のみを再作成します。 複数の -i スイッチを記述することで、複数のインデックスを再作成することができます。

-q
--quiet

進行メッセージを表示しません。

-s
--system

データベースのシステムカタログのインデックスを再作成します。

-t table
--table= table

table のインデックスのみを再作成します。 複数の -t を記述することで、複数のテーブルのインデックスを再作成することができます。

-V
--version

reindexdb のバージョンを表示し、終了します。

-?
--help

reindexdb コマンドライン引数の使用方法を表示し、終了します。

また、 reindexdb は、接続パラメータとして以下のコマンドライン引数を受け付けます。

-h host
--host= host

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

-p port
--port= port

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

-U username
--username= username

接続するユーザ名を指定します。

-w
--no-password

パスワードの入力を促しません。 サーバがパスワード認証を必要とし、かつ、 .pgpass ファイルなどの他の方法が利用できない場合、接続試行は失敗します。 バッチジョブやパスワードを入力するユーザが存在しない場合にこのオプションは有用かもしれません。

-W
--password

データベースに接続する前に、 reindexdb は強制的にパスワード入力を促します。

サーバがパスワード認証を要求する場合 reindexdb は自動的にパスワード入力を促しますので、これが重要になることはありません。 しかし、 reindexdb は、サーバにパスワードが必要かどうかを判断するための接続試行を無駄に行います。 こうした余計な接続試行を防ぐために -W の入力が有意となる場合もあります。

--maintenance-db= dbname

どのデータベースを再インデックス付けしなければならないかを見つけ出すために接続するデータベースの名前を指定します。 指定されなければ postgres データベースが使用され、もし存在しなければ template1 が使用されます。

環境

PGDATABASE
PGHOST
PGPORT
PGUSER

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

また、このユーティリティは、他のほとんどの PostgreSQL ユーティリティと同様、 libpq でサポートされる環境変数を使用します( 項31.14 を参照してください)。

診断

問題が発生した場合、考えられる原因とエラーメッセージについての説明は REINDEX psql を参照してください。 データベースサーバは、指定したホストで稼働している必要があります。 また、 libpq フロントエンドライブラリのデフォルトの設定や環境変数が適応されることに注意してください。

注釈

reindexdb の実行中には PostgreSQL サーバに何度も接続しなければならないことがありますが、この場合その度にパスワードが必要です。 そのような場合は ~/.pgpass ファイルを用意しておくと便利です。 詳細は 項31.15 を参照してください。

データベース test のインデックスを再作成します。


$ 

reindexdb test

abcd というデータベース内のテーブル foo のインデックスとインデックス bar を再作成します。


$ 

reindexdb --table foo --index bar abcd

関連項目

REINDEX

powered by SEO.CUG.NET