他のバージョンの文書 16 | 15 | 14 | 13 | 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

5.5. テーブルの変更

テーブルの作成後に間違いに気付いたり、あるいはアプリケーションの要件が変わったりした場合には、テーブルをいったんドロップして再度作成することができます。 しかし、テーブルにデータを入力済みの場合、あるいはそのテーブルが他のデータベースオブジェクト(例えば外部キー制約)によって参照されている場合、これは良い方法ではありません。 そのため、PostgreSQL では既存のテーブルに変更を加えるための一連のコマンドが用意されています。テーブル内のデータを変更するという概念ではないことに注意してください。 ここでは、テーブルの定義や構造を変更することに焦点を合わせます。

次のことができます。

これらの操作は全てALTER TABLEコマンドを使用して行うことができます。

5.5.1. 列の追加

列を追加するには、次のようにコマンドを使用します。

ALTER TABLE products ADD COLUMN description text;

新しい列にはデフォルト値が初期値として入ります(DEFAULT句を指定しない場合はNULL値が入ります)。

次の構文を使用すると、列の制約も同時に定義することができます。

ALTER TABLE products ADD COLUMN description text CHECK (description <> '');

実際にはCREATE TABLE内の列の記述に使用されている全てのオプションが、ここで使用できます。 ただしデフォルト値は与えられている制約を満足するものでなくてはならないことに注意してください。満足しない場合はADDが失敗します。一方で、新規の列に正しく値を入れた後で制約を追加することができます(後述)。

5.5.2. 列の削除

列を削除するには、次のようにコマンドを使用します。

ALTER TABLE products DROP COLUMN description;

列内にある、どんなデータであれ消去します。 また列を含むテーブルの制約も消去されます。 しかし、もし列が他のテーブルの外部キー制約として参照されている場合は、PostgreSQLは暗黙のうちに制約を消去しません。 CASCADEを追加することにより列に依存する全てを消去することができます。

ALTER TABLE products DROP COLUMN description CASCADE;

この背後にある一般的な仕組みに関する説明については項5.11を参照してください。

5.5.3. 制約の追加

制約を追加するには、テーブル制約の構文が使用されます。

ALTER TABLE products ADD CHECK (name <> '');
ALTER TABLE products ADD CONSTRAINT some_name UNIQUE (product_no);
ALTER TABLE products ADD FOREIGN KEY (product_group_id) REFERENCES product_groups;

テーブル制約として記述できない非NULL制約を追加するには、次の構文を使用します。

ALTER TABLE products ALTER COLUMN product_no SET NOT NULL;

制約は即座に検査されますので、制約を追加する前にテーブル内のデータがこれに従っている必要があります。

5.5.4. 制約の削除

制約を削除するには、その制約名を知る必要があります。 自分で名前を付けた場合は簡単です。 しかし、自分で名前を付けていない場合はシステム生成の名前が割り当てられているので、それを探さなくてはなりません。 それにはpsql\d tablenameコマンドを使用すると便利です。 他のインタフェースにもテーブルの詳細を調べる方法があるかもしれません。 コマンドは以下の通りです。

ALTER TABLE products DROP CONSTRAINT some_name;

(自動生成された$2といった制約名を扱う場合は、有効な識別子となるように二重引用符で括る必要があることを忘れないでください。)

列の削除に関して、何かが依存している制約を削除する場合にはCASCADEを付ける必要があります。例として、参照されている列に付いている一意またはプライマリキー制約に依存している外部キー制約を削除する場合です。

これは、非NULL制約以外の全ての制約型に適用できます。 非NULL制約をドロップするには、次のようにします。

ALTER TABLE products ALTER COLUMN product_no DROP NOT NULL;

(非NULL制約には名前がないことを想起してください。)

5.5.5. 列のデフォルト値の変更

列に新しいデフォルトを設定するには、以下のようなコマンドを使用します。

ALTER TABLE products ALTER COLUMN price SET DEFAULT 7.77;

これはテーブル内の既存の行には何も影響を与えないことに注意してください。これは将来のINSERTコマンドのために単純にデフォルトを変えるだけです。

デフォルト値を削除するには常に次のようにします。

ALTER TABLE products ALTER COLUMN price DROP DEFAULT;

これは、デフォルトをNULLに設定することと同等です。 そのため、定義されていないデフォルト値を削除してもエラーにはなりません。 なぜなら NULL値が暗黙的にデフォルトとなっているからです。

5.5.6. 列のデータ型の変更

列を異なるデータ型に変換するには以下のようなコマンドを使用してください。

ALTER TABLE products ALTER COLUMN price TYPE numeric(10,2);

これは、その列の既存の項目が新しい型に暗黙的キャストにより変換できる場合にのみ成功します。 より複雑な変換が必要な場合、古い値から新しい値をどのように計算するかを指定するUSING句を付けることができます。

PostgreSQLは、(もしあれば)列のデフォルト値を新しい型に、同時に、その列に関連する全ての制約も新しい型に変換しようとします。 しかし、こうした変換は失敗するかもしれませんし、予想を超えた結果になってしまうかもしれません。 型を変更する前にその列に関する制約を全て削除し、後で適切に変更した制約を付け直すことが最善な場合がよくあります。

5.5.7. 列名の変更

列名を変更するには、次のようにします。

ALTER TABLE products RENAME COLUMN product_no TO product_number;

5.5.8. テーブル名の変更

テーブル名を変更するには、次のようにします。

ALTER TABLE products RENAME TO items;