指定したテーブルに対して新しいレコードを追加する処理を行います。

INSERT文では、データを追加するカラムを指定する方法と指定しない方法で記述する際の注意点が異なります。

・INSERT文でカラムを指定する場合

カラムを指定する場合の構文は、次の通りになります。

INSERT INTO <テーブル名> ( <カラム名1>, <カラム名2>, …) 
VALUES ( <値1>, <値2>, …);

カラムを指定する場合の注意点は、次の通りになります。

　・<テーブル名>の後に値を設定するカラムを指定します。

　・指定したカラムの数だけVALUES句の後に値を指定します。

　・<テーブル名>とVALUES句の値の並び順は紐づいています。

　・対象テーブルの全てのカラムを指定する必要はありません。

　・指定しなかったカラムにはNULLまたはカラムのデフォルト値が設定されます。

・INSERT文でカラムを指定しない場合

カラムを指定する場合の構文は、次の通りになります。

INSERT INTO <テーブル名>
VALUES ( <値1>, <値2>, …);

カラムを指定しない場合の注意点は、次の通りになります。

　・VALUES句に対象テーブルに存在するカラム数分の値を設定する必要があります。

　・設定する値はテーブルのカラム順に設定する必要があります。

・複数のレコードをまとめて追加

複数のレコードをまとめて追加する場合は、VALUES句に「( <値1>, <値2>, …)」を複数記述します。

カラムを指定する場合、指定しない場合の両方でVALUES句以下の書き方は同様です。

例として、3レコードを追加する場合の構文は、次の通りになります。

INSERT INTO <テーブル名> ( <カラム名1>, <カラム名2>, …) VALUES 
( <値1>, <値2>, …),
( <値3>, <値4>, …),
( <値5>, <値6>, …);

・よく起こるエラー

INSERT文の実行でよく起こるエラーとして、次のようなものがあります。


■列と値の数が不一致

カラムを指定する場合、指定しない場合の両方で発生する可能性があります。

カラムを指定する場合では、テーブル名の後にカラムを5つ指定したが、VALUES句で値を3つしか指定しなかったため、エラーが発生しデータの追加に失敗します。

カラムを指定しない場合では、対象テーブルにカラム数が5つありますが、VALUES句で値を3つしか指定しなかったため、エラーが発生しデータの追加に失敗します。


■対象カラムのデータ型と値のデータ型が不一致

データを追加するカラムと追加する値のデータ型が一致していない場合は、エラーとなりデータの追加に失敗します。

また、暗黙的データ型変換ができない場合も同様にエラーとなります。


■NOT NULL制約が設定されたカラムにNULLを設定

NOT NULL制約が設定されたカラムには、NULLを設定することが許可されていないため、NULLを設定することができません。

NULLを設定した場合には、エラーとなりデータの追加に失敗します。


■主キー制約に違反する値を設定

主キー制約が設定されたカラムには、重複した値を設定することができません。

重複した値を設定した場合には、エラーとなりデータの追加に失敗します。

サブクエリから返された複数のレコードを同時に複数のテーブルへ追加できます。

ただし、レコードを追加できるのは、テーブルのみになるため、ビューなどを追加することはできません。

マルチテーブルINSERTは、次の3つに分類されます。

　・無条件INSERT

　・条件付きINSERT ALL

　・条件付きINSERT FIRST

・無条件INSERT

サブクエリから返された各レコードのINTO句で指定したテーブルに追加されます。

　・SELECT文のサブクエリの結果をINTO句で指定した全てのテーブルに追加されます。

　・INTO句は複数指定できます。

　・VALUES句にはカラム名やリテラルを指定できます。

　・サブクエリが返すカラム数と対象テーブルのカラム数が同じ場合はVALUES句を省略できます。

　・前述の「INSERT文でカラムを指定しない場合」と同様の動作になるため、VALUES句に指定するカラム（リテラル）数が過不足の場合は、エラーとなります。


無条件INSERTを行う構文は、次の通りです。

INSERT ALL
INTO <テーブル名> VALUES (...)
INTO <テーブル名> VALUES (...)
SELECT …;

例として、SELECT文でテーブルAのデータを抽出して、テーブル1とテーブル2にデータを追加するとします。


その場合のINSERT文の記述は、次の通りになります。

これにより、テーブル1には、テーブルAのAとCカラムの値が追加され、テーブル2には、テーブルAのAとBの値が追加されます。

INSERT ALL
INTO テーブル1 VALUES (A, C)
INTO テーブル2 VALUES (A, B);
SELECT A, B, C FROM テーブルA;

ただし、以下のようにVALUES句に指定するカラム（リテラル）数が過不足の場合は、エラーになるため注意が必要です。

NULLを指定するか、リテラルを指定することでエラーを回避できます。

INSERT ALL
INTO テーブル1 VALUES (A, C)
INTO テーブル2 VALUES (A, B);
SELECT A, B, C FROM テーブルA;

テーブル3には、A,B,Dの3カラムありますが、VALUES句に2カラムしか記述していない場合などエラーになります。

・条件付きINSERT

WHEN句に条件を指定して条件を満たす場合にWHEN句内で指定したテーブルにデータが追加されます。

　・条件付きINSERTには、INSERTの後に「ALL」か「FIRST」を指定します。

　・SELECT文のサブクエリが返す結果がWHEN句に指定した条件を満たす場合に、WHEN句内に指定したテーブルにデータが追加されます。

　・1つのWHEN句内に複数のINTO句を指定できます。

　・全てのWHEN句の条件を満たさない場合は、ELSE句に指定したテーブルにデータが追加されます。ELSE句は、省略可能です。

　・VALUES句にはカラム名やリテラルを指定できます。

　・サブクエリが返すカラム数と対象テーブルのカラム数が同じ場合はVALUES句を省略できます。

　・前述の「INSERT文でカラムを指定しない場合」と同様の動作になるため、VALUES句に指定するカラム（リテラル）数が過不足の場合は、エラーとなります。


条件付きINSERTを行う構文は、次の通りです。

INSERT ALL
    WHEN <条件1> THEN
INTO <テーブル名> VALUES (...)
WHEN <条件2> T