SQLのINSERT文とは?VALUESでデータを追加する書き方
INSERTは、表に新しい行を追加するSQLです。商品表に商品を1件追加する、まとめて追加する、別の表の内容をコピーして追加する、といった作業ができます。追加前の表と追加後の表を見比べながら読みましょう。
例で使う表
productsは1行が商品1件です。idは主キー、nameは商品名、priceは価格(円)、stockは在庫数で、stockを省略すると0が入ります。arrivalsは入荷予定の商品で、products追加用の元データです。以降の各例では、実行前の状態から追加し、追加後のproductsをid順に表示した結果を示します。
| id | name | price | stock |
|---|---|---|---|
| 1 | ノート | 200 | 50 |
| 2 | ペン | 120 | 100 |
| 3 | 消しゴム | 80 | 0 |
| id | name | price | stock |
|---|---|---|---|
| 4 | 定規 | 150 | 30 |
| 5 | 付箋 | 100 | 20 |
INSERTの基本構文
INSERT INTO products (id, name, price, stock)
VALUES (4, '定規', 150, 30);INSERT INTO ... VALUESで1行を追加する
INSERT INTOの後に表名と列名のリスト、VALUESの後に同じ順番で値を書きます。列名と値は位置で対応します。文字列はシングルクォートで囲みます。この文を実行すると、定規の行が1件増えて4行になります。INSERT自体は結果表を返さないため、追加後の表はSELECTで確認します。
INSERT INTO products (id, name, price, stock)
VALUES (4, '定規', 150, 30);
SELECT * FROM products ORDER BY id;| id | name | price | stock |
|---|---|---|---|
| 1 | ノート | 200 | 50 |
| 2 | ペン | 120 | 100 |
| 3 | 消しゴム | 80 | 0 |
| 4 | 定規 | 150 | 30 |
列を省略してDEFAULTの値に任せる
列名のリストに書かなかった列には、その列のDEFAULT、なければNULLが入ります。stockにはDEFAULT 0があるので、定規の在庫は0になります。NOT NULLでDEFAULTもない列を省略するとエラーになるため、nameやpriceは省略できません。
INSERT INTO products (id, name, price)
VALUES (4, '定規', 150);
SELECT * FROM products ORDER BY id;| id | name | price | stock |
|---|---|---|---|
| 1 | ノート | 200 | 50 |
| 2 | ペン | 120 | 100 |
| 3 | 消しゴム | 80 | 0 |
| 4 | 定規 | 150 | 0 |
VALUESに複数行を並べてまとめて追加する
VALUESの後に、カッコで囲んだ行をカンマで区切って並べると、1つの文で複数行を追加できます。定規と付箋を1回で追加し、表は5行になります。どれか1行でも制約に反するとエラーになり、追加される行はありません。
INSERT INTO products (id, name, price, stock)
VALUES
(4, '定規', 150, 30),
(5, '付箋', 100, 20);
SELECT * FROM products ORDER BY id;| id | name | price | stock |
|---|---|---|---|
| 1 | ノート | 200 | 50 |
| 2 | ペン | 120 | 100 |
| 3 | 消しゴム | 80 | 0 |
| 4 | 定規 | 150 | 30 |
| 5 | 付箋 | 100 | 20 |
INSERT ... SELECTで別の表の行を追加する
VALUESの代わりにSELECTを書くと、別の表の検索結果をそのまま追加できます。arrivalsの2行をproductsへコピーするため、列名リストとSELECTの列は同じ数・同じ順番にします。入荷予定の表は変わらず、productsだけが5行になります。
INSERT INTO products (id, name, price, stock)
SELECT id, name, price, stock
FROM arrivals;
SELECT * FROM products ORDER BY id;| id | name | price | stock |
|---|---|---|---|
| 1 | ノート | 200 | 50 |
| 2 | ペン | 120 | 100 |
| 3 | 消しゴム | 80 | 0 |
| 4 | 定規 | 150 | 30 |
| 5 | 付箋 | 100 | 20 |
RETURNINGで追加した行をその場で受け取る
RETURNINGを付けると、追加した行の値をINSERTの結果として受け取れます。stockを省略した行にはDEFAULTの0が入っていることを、別のSELECTなしで確認できます。結果には追加した1行だけが出ます。
INSERT INTO products (id, name, price)
VALUES (4, '定規', 150)
RETURNING *;| id | name | price | stock |
|---|---|---|---|
| 4 | 定規 | 150 | 0 |
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公式ドキュメントを参照し、初めて学ぶ人向けに日本語で整理しています。
- PostgreSQL公式:データの挿入 — INSERTの基本、列の省略、複数行
- PostgreSQL公式:INSERT — INSERTの構文、DEFAULT、ON CONFLICT、RETURNING
- PostgreSQL公式:変更した行からのデータ返却 — RETURNING句の使い方