ALTER TYPE name action [, ... ]
ALTER TYPE name OWNER TO new_owner
ALTER TYPE name RENAME ATTRIBUTE attribute_name TO new_attribute_name
ALTER TYPE name RENAME TO new_name [ CASCADE | RESTRICT ]
ALTER TYPE name SET SCHEMA new_schema
ALTER TYPE name ADD VALUE new_enum_value [ { BEFORE | AFTER } existing_enum_value ]
ここでactionは以下のいずれかです。
ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ]
DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ]
ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ]
ALTER TYPEは既存の型の定義を変更します。 複数の副構文があります。
この構文は、CREATE TYPEと同じ構文を用いて、複合型に新しい属性を追加します。
この構文は複合型から属性を削除します。 IF EXISTSが指定された時にその属性が存在しないでもエラーにはなりません。 この場合は代わりに注意が発せられます。
この構文は複合型の属性の型を変更します。
この構文は型の所有者を変更します。
この構文は型の名前または複合型の個々の属性の名前を変更します。
この構文は型を他のスキーマに移動します。
この構文は列挙型に新しい値を追加します。 BEFOREまたはAFTERによって列挙型の順番における新しい値の場所が指定されていない場合、新しい項目は値リストの最後に格納されます。
自動的に変更される型で型付けされたテーブルとその子テーブルにこの操作を伝播します。
変更対象の型がテーブルの型付けに使用されている場合に拒絶します。 これがデフォルトです。
ADD ATTRIBUTE、DROP ATTRIBUTE、ALTER ATTRIBUTE操作は複数の変更リストにまとめて、並行して適用することができます。 例えば、複数の属性の追加、複数の属性の変更、またはその両方を1つのコマンドで実行することができます。
ALTER TYPEを使用するには型の所有者でなければなりません。 型のスキーマを変更するには、新しいスキーマにおけるCREATE権限も必要です。 所有者を変更するには、直接または間接的に新しい所有者ロールのメンバでなければなりません。 また、そのロールが型のスキーマにおいてCREATEを持たなければなりません。 (この制限により、強制的に、所有者の変更が型の削除と再作成で行うことができない何らかの処理を行わないようになります。 しかし、スーパーユーザはすべての型の所有者を変更することができます。)
変更対象の既存の型の名前です(スキーマ修飾名も可)。
新しい型の名前です。
新しい型の所有者のユーザ名です。
型の新しいスキーマです。
追加、変更または削除する属性の名前です。
変名する属性の新しい名前です。
追加する属性のデータ型、または、変更する属性の新しい型です。
列挙型リストの値に追加する新しい値です。 すべての列挙型のリテラル同様、引用符を付けなければなりません。
列挙型の並び順序において新しい値をその直前または直後に追加する、既存の列挙型の値です。 すべての列挙型のリテラル同様、引用符を付けなければなりません。
ALTER TYPE ... ADD VALUE(列挙型に新しい値を追加する構文)はトランザクションブロック内で実行することはできません。
追加された列挙型の値を含む比較は、列挙型の元々の要素のみを含む比較よりも低速になることがあります。 通常これは、新しい値のソート位置がリストの最後ではなくBEFOREまたはAFTERを用いて設定された場合のみで起こります。 しかし最後に新しい値が追加された場合であっても起こる可能性があります。 (これは、OIDカウンタが元の列挙型を作成してから"周回"した場合に起こります。) この低下は通常は大きくありません。 しかしこれが問題であれば、列挙型を削除し再作成する、あるいはデータベースをダンプし再ロードすることで最適な性能まで戻すことができます。
データ型の名前を変更します。
ALTER TYPE electronic_mail RENAME TO email;
email型の所有者をjoeに変更します。
ALTER TYPE email OWNER TO joe;
email型のスキーマをcustomersに変更します。
ALTER TYPE email SET SCHEMA customers;
型に新しい属性を追加します。
ALTER TYPE compfoo ADD ATTRIBUTE f3 int;
列挙型の特定のソート位置に新しい値を追加します。
ALTER TYPE colors ADD VALUE 'orange' AFTER 'red';