SQL練習室
← SQLガイド

SQLのINSERT文とは?VALUESでデータを追加する書き方

INSERTは、表に新しい行を追加するSQLです。商品表に商品を1件追加する、まとめて追加する、別の表の内容をコピーして追加する、といった作業ができます。追加前の表と追加後の表を見比べながら読みましょう。

例で使う表

productsは1行が商品1件です。idは主キー、nameは商品名、priceは価格(円)、stockは在庫数で、stockを省略すると0が入ります。arrivalsは入荷予定の商品で、products追加用の元データです。以降の各例では、実行前の状態から追加し、追加後のproductsをid順に表示した結果を示します。

products:商品3件(追加前)
idnamepricestock
1ノート20050
2ペン120100
3消しゴム800
arrivals:入荷予定2件
idnamepricestock
4定規15030
5付箋10020

INSERTの基本構文

sql
INSERT INTO products (id, name, price, stock)
VALUES (4, '定規', 150, 30);

INSERT INTO ... VALUESで1行を追加する

INSERT INTOの後に表名と列名のリスト、VALUESの後に同じ順番で値を書きます。列名と値は位置で対応します。文字列はシングルクォートで囲みます。この文を実行すると、定規の行が1件増えて4行になります。INSERT自体は結果表を返さないため、追加後の表はSELECTで確認します。

sql
INSERT INTO products (id, name, price, stock)
VALUES (4, '定規', 150, 30);

SELECT * FROM products ORDER BY id;
実行結果
idnamepricestock
1ノート20050
2ペン120100
3消しゴム800
4定規15030

列を省略してDEFAULTの値に任せる

列名のリストに書かなかった列には、その列のDEFAULT、なければNULLが入ります。stockにはDEFAULT 0があるので、定規の在庫は0になります。NOT NULLでDEFAULTもない列を省略するとエラーになるため、nameやpriceは省略できません。

sql
INSERT INTO products (id, name, price)
VALUES (4, '定規', 150);

SELECT * FROM products ORDER BY id;
実行結果
idnamepricestock
1ノート20050
2ペン120100
3消しゴム800
4定規1500

VALUESに複数行を並べてまとめて追加する

VALUESの後に、カッコで囲んだ行をカンマで区切って並べると、1つの文で複数行を追加できます。定規と付箋を1回で追加し、表は5行になります。どれか1行でも制約に反するとエラーになり、追加される行はありません。

sql
INSERT INTO products (id, name, price, stock)
VALUES
  (4, '定規', 150, 30),
  (5, '付箋', 100, 20);

SELECT * FROM products ORDER BY id;
実行結果
idnamepricestock
1ノート20050
2ペン120100
3消しゴム800
4定規15030
5付箋10020

INSERT ... SELECTで別の表の行を追加する

VALUESの代わりにSELECTを書くと、別の表の検索結果をそのまま追加できます。arrivalsの2行をproductsへコピーするため、列名リストとSELECTの列は同じ数・同じ順番にします。入荷予定の表は変わらず、productsだけが5行になります。

sql
INSERT INTO products (id, name, price, stock)
SELECT id, name, price, stock
FROM arrivals;

SELECT * FROM products ORDER BY id;
実行結果
idnamepricestock
1ノート20050
2ペン120100
3消しゴム800
4定規15030
5付箋10020

RETURNINGで追加した行をその場で受け取る

RETURNINGを付けると、追加した行の値をINSERTの結果として受け取れます。stockを省略した行にはDEFAULTの0が入っていることを、別のSELECTなしで確認できます。結果には追加した1行だけが出ます。

sql
INSERT INTO products (id, name, price)
VALUES (4, '定規', 150)
RETURNING *;
実行結果
idnamepricestock
4定規1500

INSERTでよくある間違い

主キーがすでにある値を追加するとエラーになる

idは主キーなので、すでにあるid 3をもう一度INSERTすると重複エラーになり、その文では何も追加されません。新しい行には使われていないidを指定します。

列名リストと値の数を合わせる

INSERT INTO products (id, name, price) VALUES (4, '定規')のように列数と値の数が合わないと、構文エラーになります。列名と値は先頭から順に対応させます。

実際に1問解いてみる

INSERT・VALUES

productsに、id 4、名前「定規」、価格150、在庫30の商品を1行追加してください。

テーブル

読み込み中…

実行結果

関連構文

INSERTについてよくある質問

列名のリストは省略できますか?
できます。INSERT INTO products VALUES (4, '定規', 150, 30)のように書くと、表を作ったときの列の順番で値が対応します。列の追加や順番の変更で壊れやすいため、列名を書くほうが安全です。
追加した結果はどう確認しますか?
追加後にSELECTで表を見るか、INSERTにRETURNINGを付けて追加した行を受け取ります。このページの各例では、確認用のSELECTを続けて示しています。
文字列の値はどう書きますか?
シングルクォートで囲みます。ダブルクォートは表名や列名などの識別子を囲む記号で、値には使いません。
一度に複数行を追加できますか?
VALUESに複数行を並べるか、INSERT ... SELECTを使えば、1つの文で複数行を追加できます。どれか1行でも制約に反すると、その文で追加される行はありません。

参考文献

内容はPostgreSQL公式ドキュメントを参照し、初めて学ぶ人向けに日本語で整理しています。