ALTER INDEX — インデックス定義を変更する
ALTER INDEX [ IF EXISTS ]name
RENAME TOnew_name
ALTER INDEX [ IF EXISTS ]name
SET TABLESPACEtablespace_name
ALTER INDEXname
DEPENDS ON EXTENSIONextension_name
ALTER INDEX [ IF EXISTS ]name
SET (storage_parameter
=value
[, ... ] ) ALTER INDEX [ IF EXISTS ]name
RESET (storage_parameter
[, ... ] ) ALTER INDEX ALL IN TABLESPACEname
[ OWNED BYrole_name
[, ... ] ] SET TABLESPACEnew_tablespace
[ NOWAIT ]
ALTER INDEX
は既存のインデックスの定義を変更します。
以下のような副構文が存在します。
RENAME
このRENAME
構文は、インデックスの名前を変更します。
格納されたデータには影響しません。
SET TABLESPACE
この構文は、インデックスのテーブル空間を指定したテーブル空間に変更し、インデックスに関連するデータファイルを移動します。
インデックスのテーブル空間を変更するには、インデックスの所有者であり、かつ新しいテーブル空間のCREATE
権限を有している必要があります。
ALL IN TABLESPACE
構文を使うことで、テーブル空間内の現在のデータベースのすべてのインデックスを移動することができます。
この場合、移動されるすべてのインデックスがロックされ、それから1つずつ移動されます。
この構文はOWNED BY
もサポートしており、これを使うと、指定のロールが所有しているインデックスだけを移動します。
NOWAIT
オプションを指定した場合、必要とするすべてのロックを即座に獲得できなければ、このコマンドは失敗します。
このコマンドではシステムカタログは移動されないことに注意してください。
必要であれば、ALTER DATABASE
を使うか、あるいはALTER INDEX
で明示的に指定してください。
CREATE TABLESPACEも参照してください。
DEPENDS ON EXTENSION
この構文は、インデックスが拡張に依存するものとして印をつけます。 これにより、拡張が削除されたときに、インデックスも自動的に削除されるようになります。
SET ( storage_parameter
= value
[, ... ] )
この構文は、インデックスに対し、インデックスメソッド固有の1つ以上の格納パラメータを変更します。 設定可能なパラメータについてはCREATE INDEXを参照してください。 このコマンドにより、インデックスの内容がすぐに変更されるわけではないことに注意してください。 パラメータによりますが、期待する効果を得るためにREINDEXを使用してインデックスを再構築しなければならない場合もあります。
RESET ( storage_parameter
[, ... ] )
この構文は、1つ以上のインデックスメソッド固有の格納パラメータをデフォルト値に再設定します。
SET
同様、インデックスを完全に更新するためにREINDEX
が必要になる場合があります。
IF EXISTS
インデックスが存在しない場合にエラーとしません。 この場合注意メッセージが発生します。
name
変更対象の既存のインデックスの名前です(スキーマ修飾名も可)。
new_name
インデックスの新しい名前です。
tablespace_name
インデックスの移動先のテーブル空間です。
extension_name
インデックスが依存することになる拡張の名前です。
storage_parameter
インデックスメソッド固有の格納パラメータの名前です。
value
インデックスメソッド固有の格納パラメータの新しい値です。 パラメータに応じてこれが数値になることも文字列になることもあります。
これらの操作はALTER TABLEを使用して行うこともできます。
実際には、ALTER INDEX
は、ALTER TABLE
のインデックス用構文の別名に過ぎません。
以前はALTER INDEX OWNER
という種類の構文がありましたが、(警告の上)無視されるようになりました。
インデックスの所有者は基のテーブルの所有者と異なるものにすることができません。
テーブルの所有者を変更すると自動的にインデックスの所有者も変わります。
システムカタログ用インデックスに対する変更は許されていません。
既存のインデックスの名前を変更します。
ALTER INDEX distributors RENAME TO suppliers;
インデックスを別のテーブル空間に移動します。
ALTER INDEX distributors SET TABLESPACE fasttablespace;
インデックスのフィルファクタを変更します(インデックスメソッドがフィルファクタをサポートしていることを前提とします)。
ALTER INDEX distributors SET (fillfactor = 75); REINDEX INDEX distributors;
ALTER INDEX
はPostgreSQLの拡張です。