【SQL INSERT入門】INSERT INTO文でテーブルに新しいデータを追加する方法
Webサイトの会員登録、ブログの新規投稿、ECサイトの商品登録…。Webアプリケーションが活気づくのは、新しいデータが次々と生まれるからです。この「新しいデータをデータベースに登録する」という最も基本的で重要な操作を担うのが、SQLのINSERT文です。
INSERT文は、データベースという巨大な台帳に新しい行を書き込むための命令です。その構文は一見シンプルですが、一行だけの追加から複数行の一括登録、さらには別のテーブルからのデータコピーまで、多彩な使い方があります。しかし、シンプルなだけに、ちょっとした間違いでエラーが出てしまい、初心者がつまずきやすいポイントでもあります。
この記事では、Webクリエーターを目指す皆さんがINSERT文を完全にマスターできるよう、基本的な書き方から実用的な応用例、そして頻出エラーとその対処法までを、たくさんの「コピペで動くコード」と共に徹底解説します。まずはコードを動かして「データが追加される！」という手応えを感じながら、SQLの世界への第一歩を踏み出しましょう。
準備：データを追加するためのテーブルを用意しよう
データを追加するには、まずそのデータを入れておくための「箱」、つまりテーブルが必要です。今回は、新商品の情報を管理するproductsというテーブルを作成してみましょう。このテーブルは、この記事を通してずっと使っていきます。
注目すべきはid列のINTEGER PRIMARY KEYです。多くのデータベース（SQLite、MySQLのAUTO_INCREMENTなど）では、このように設定すると、データを追加するたびにユニークなIDが自動で割り振られるようになります。これが後ほど重要になります。
-- もしproductsテーブルが存在すれば削除（繰り返し試せるように）
DROP TABLE IF EXISTS products;
-- 新しいproductsテーブルを作成
CREATE TABLE products (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
category TEXT,
price INTEGER,
release_date DATE
);
これで、商品データを登録するための空っぽのテーブルが用意できました。早速、このテーブルに新しい命を吹き込んでいきましょう。
【基本】INSERT INTO ... VALUES: 1行のデータを追加する
まずはINSERT文の基本形、「1行のデータを追加する」方法です。構文はINSERT INTO テーブル名 (列1, 列2, ...) VALUES (値1, 値2, ...);となります。()内の列リストとVALUESの後の値リストが、順番通りに1対1で対応するのがポイントです。
INSERT INTO products (name, category, price, release_date)
VALUES ('奇跡のリンゴ', '食品', 500, '2025-07-01');
このクエリを実行すると、productsテーブルに新しい商品が1件追加されます。id列は指定していませんが、テーブル作成時に自動で番号が振られるように設定したため、データベースが自動的に1を割り当ててくれます。これが主キー（PRIMARY KEY）を自動採番にする大きなメリットです。
追加されたか確認してみましょう。SELECT * FROM products;を実行すると、今追加したデータが表示されるはずです。
SELECT * FROM products;実行結果:
id | name | category | price | release_date
---|-------------|----------|-------|-------------
1 | 奇跡のリンゴ | 食品 | 500 | 2025-07-01また、一部の列の値がまだ決まっていない場合（NULLが許可されている列に限る）、その列を省略してINSERTすることも可能です。
-- 価格(price)と発売日(release_date)を省略してINSERT
INSERT INTO products (name, category)
VALUES ('幻の桃', '食品');
この場合、priceとrelease_dateにはNULL（値なし）が入ります。
【応用1】複数行のデータを一括で追加する
新商品を一つずつ登録するのは少し面倒ですね。INSERT文では、複数のデータを一度のクエリでまとめて追加することができます。
書き方は簡単で、VALUESの後に()で囲んだ値のリストをカンマ（,）で区切って並べるだけです。これにより、データベースとの通信が1回で済み、1行ずつINSERTを繰り返すよりも効率が良くなります。
INSERT INTO products (name, category, price, release_date) VALUES
('魔法のキーボード', 'ガジェット', 12000, '2025-07-10'),
('虹色マウス', 'ガジェット', 5000, '2025-07-20'),
('天空のブドウ', '食品', 2500, '2025-08-01');
この1つのクエリで、3つの商品データが一気に追加されました。初期データの投入や、CSVファイルから読み込んだデータをまとめて登録する際などに非常に便利なテクニックです。
【応用2】`INSERT ... SELECT`文で他のテーブルからデータをコピーする
これは中級者向けの非常に強力なテクニックです。INSERT ... SELECT文を使うと、別のテーブルからSELECT文で取得した結果を、そのまま新しいテーブルに追加することができます。
例えば、「入荷予定リスト」テーブル（new_arrivals）から、正式に発売が決まった商品だけをproductsテーブルに移す、といったシナリオで大活躍します。
まず、コピー元となるnew_arrivalsテーブルを作成し、データを登録しておきましょう。
-- コピー元のテーブルを作成
CREATE TABLE new_arrivals (
product_name TEXT NOT NULL,
product_category TEXT,
list_price INTEGER,
launch_date DATE,
is_confirmed INTEGER -- 発売が確定したら1、そうでなければ0
);
-- 入荷予定リストにデータを登録
INSERT INTO new_arrivals VALUES
('究極のヘッドフォン', 'オーディオ', 28000, '2025-09-01', 1),
('未来のVRゴーグル', 'ガジェット', 75000, '2025-10-01', 1),
('全自動コーヒーメーカー', '家電', 18000, '2025-09-15', 0);
準備ができました。それでは、new_arrivalsテーブルから発売が確定している（is_confirmed = 1）商品だけを選び出し、productsテーブルに追加しましょう。
INSERT INTO products (name, category, price, release_date)
SELECT product_name, product_category, list_price, launch_date
FROM new_arrivals
WHERE is_confirmed = 1;
このクエリのポイントは、VALUES句の代わりにSELECT文が使われている点です。SELECT文で取得される列の構成（列の数、順序、データ型）が、INSERT INTO products (...)で指定された列構成と一致している必要があります。データのバックアップや、集計結果を別のテーブルに保存する際など、用途は非常に幅広いです。
初心者がつまずくINSERT文のエラーと対処法
INSERT文は、データベースのルール（制約）を破るとすぐにエラーを返します。ここでは、初心者が遭遇しがちな代表的なエラーとその原因、対処法を見ていきましょう。
エラー1：主キー（PRIMARY KEY）の重複
これは最もよく見るエラーです。主キーはテーブル内で絶対に重複してはならない、唯一の識別子です。もし手動でIDを指定していて、すでに使われているIDを再び使おうとするとエラーになります。
例えば、ID=1の「奇跡のリンゴ」はすでに登録されています。もう一度ID=1で新しい商品を登録しようとすると…
-- これはエラーになります！
INSERT INTO products (id, name, category, price, release_date)
VALUES (1, '別のリンゴ', '食品', 300, '2025-07-02');
これを実行すると、UNIQUE constraint failed: products.id や Duplicate entry '1' for key 'PRIMARY' といったエラーメッセージが表示されます。
対処法： 主キーは手動で管理せず、データベースの自動採番機能に任せるのが最も安全で確実です。最初の例のように、INSERT文の列リストにidを含めないようにしましょう。
エラー2：NOT NULL制約違反
テーブル作成時にNOT NULLと指定した列は、必ず値を入れる必要があります。この列を省略してINSERTしようとするとエラーになります。
productsテーブルのname列はNOT NULLです。もしnameを指定せずにINSERTしようとすると…
-- これもエラーになります！
INSERT INTO products (category, price)
VALUES ('その他', 1000);
NOT NULL constraint failed: products.name のようなエラーが表示されます。
対処法： NOT NULL制約のある列には、必ず何らかの値を指定してください。もし空の文字列でも許容したい場合は、''のように指定します。
エラー3：データ型の不一致
テーブル定義で定められたデータ型と違う型のデータを入れようとするとエラーになります。例えば、数値型（INTEGER）のprice列に文字列を入れようとするケースです。
-- これも当然エラーになります！
INSERT INTO products (name, price)
VALUES ('高価な石', '値段は秘密');
Datatype mismatch や Incorrect integer value: '値段は秘密' for column 'price' のようなエラーが出ます。
対処法： テーブルの定義をよく確認し、各列に合ったデータ型の値を指定してください。数値を文字列として'500'のようにクォートで囲んでしまうミスもよくあるので注意しましょう。
【体験コーナー】ブラウザでSQLを動かして、データを追加してみよう！
さあ、知識をスキルに変える時間です！ 以下のHTMLコードを丸ごとコピーして、sql_insert_test.htmlのようなファイル名で保存し、ブラウザで開いてみてください。あなた専用のSQL実行環境が立ち上がり、この記事で作成したproductsテーブルが用意されています。
自由にINSERT文を書いて「実行」ボタンを押し、そのすぐ下にSELECT * FROM products;を書いて再度「実行」して、データが本当に追加されたか確かめてみましょう。エラーをわざと起こしてみるのも、良い勉強になりますよ！
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>SQL INSERT文 オンライン実行環境</title>
<style>
body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; line-height: 1.7; color: #333; max-width: 800px; margin: 2rem auto; padding: 0 1rem; }
h1 { color: #2c3e50; }
textarea { width: 100%; height: 180px; font-family: "SF Mono", "Consolas", monospace; font-size: 16px; padding: 12px; border: 1px solid #ccc; border-radius: 6px; box-sizing: border-box; margin-bottom: 1rem; }
button { background-color: #27ae60; color: white; border: none; padding: 12px 22px; font-size: 16px; border-radius: 6px; cursor: pointer; transition: background-color 0.2s; }
button:hover { background-color: #229954; }
button:disabled { background-color: #bdc3c7; cursor: not-allowed; }
#result-container { margin-top: 2rem; border: 1px solid #ddd; padding: 1rem; border-radius: 6px; background: #fdfdfd; min-height: 50px; }
#status-message { color: #27ae60; font-weight: bold; }
#error-message { color: #e74c3c; font-weight: bold; }
table { border-collapse: collapse; width: 100%; margin-top: 1rem; }
th, td { border: 1px solid #ddd; padding: 10px; text-align: left; }
th { background-color: #f2f2f2; }
tr:nth-child(even) { background-color: #f9f9f9; }
</style>
<script src="https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.10.3/sql-wasm.js"></script>
</head>
<body>
<h1>SQLを試してみよう！</h1>
<p>下のテキストエリアにSQL文を入力して「実行」ボタンを押してください。自分で考えた商品のINSERT文を試してみましょう！</p>
<textarea id="sql-input">-- ここにINSERT文やSELECT文を書いてみよう
INSERT INTO products (name, category, price, release_date)
VALUES ('無重力チェア', '家具', 45000, '2025-11-11');
SELECT * FROM products;
</textarea>
<button id="execute-btn">実行</button>
<div id="result-container">
<p id="status-message"></p>
<p id="error-message"></p>
<div id="result-output"></div>
</div>
<script>
const sqlInput = document.getElementById('sql-input');
const executeBtn = document.getElementById('execute-btn');
const statusMsg = document.getElementById('status-message');
const errorMsg = document.getElementById('error-message');
const resultOutput = document.getElementById('result-output');
let db;
async function initDb() {
executeBtn.disabled = true;
executeBtn.textContent = 'DB準備中...';
try {
const SQL = await initSqlJs({
locateFile: file => `https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.10.3/${file}`
});
db = new SQL.Database();
const setupSql = `
DROP TABLE IF EXISTS products;
CREATE TABLE products (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
category TEXT,
price INTEGER,
release_date DATE
);
`;
db.run(setupSql);
executeBtn.disabled = false;
executeBtn.textContent = '実行';
statusMsg.textContent = '準備完了！INSERT文でデータを追加し、SELECT文で結果を確認してみましょう。';
} catch (err) {
errorMsg.textContent = 'データベースの初期化に失敗しました: ' + err.message;
console.error(err);
}
}
function executeSql() {
if (!db) return;
const sql = sqlInput.value;
statusMsg.textContent = '';
errorMsg.textContent = '';
resultOutput.innerHTML = '';
try {
const statements = sql.split(';').filter(s => s.trim() !== '');
let lastResult;
statements.forEach(stmt => {
const trimmedStmt = stmt.trim();
if (trimmedStmt.toUpperCase().startsWith('INSERT') || trimmedStmt.toUpperCase().startsWith('UPDATE') || trimmedStmt.toUpperCase().startsWith('DELETE')) {
db.run(trimmedStmt);
const changes = db.getRowsModified();
statusMsg.innerHTML += `クエリ「${trimmedStmt.substring(0, 30)}...」が実行され、${changes}行が変更されました。<br>`;
} else {
const results = db.exec(trimmedStmt);
lastResult = results;
}
});
if (lastResult && lastResult.length > 0) {
lastResult.forEach(result => {
const table = document.createElement('table');
const thead = document.createElement('thead');
const tbody = document.createElement('tbody');
const headerRow = document.createElement('tr');
result.columns.forEach(colName => {
const th = document.createElement('th');
th.textContent = colName;
headerRow.appendChild(th);
});
thead.appendChild(headerRow);
result.values.forEach(row => {
const bodyRow = document.createElement('tr');
row.forEach(cellValue => {
const td = document.createElement('td');
td.textContent = cellValue === null ? 'NULL' : cellValue;
bodyRow.appendChild(td);
});
tbody.appendChild(bodyRow);
});
table.appendChild(thead);
table.appendChild(tbody);
resultOutput.appendChild(table);
});
}
} catch (err) {
errorMsg.textContent = 'SQLエラー: ' + err.message;
console.error(err);
}
}
executeBtn.addEventListener('click', executeSql);
initDb();
</script>
</body>
</html>INSERTの仲間たち：CRUD操作
INSERTを覚えたあなたは、データベース操作の基本的な4つの力のうち、1つを手に入れたことになります。この4つの操作は、それぞれの頭文字をとってCRUD（クラッド）と呼ばれ、あらゆるアプリケーションのデータ操作の基礎となります。
- C (Create): 新しいデータを作成する →
INSERT文（今回学びました！） - R (Read): データを読み取る →
SELECT文 - U (Update): 既存のデータを更新する →
UPDATE文 - D (Delete): 既存のデータを削除する →
DELETE文
SELECTはすでにおなじみですね。データを「追加」できるようになった今、次は「更新（UPDATE）」や「削除（DELETE）」の方法を学んでいくと、データベースでできることの幅がさらに大きく広がります。
まとめ
今回は、データベースに新しいデータを追加するためのINSERT文について、その基本から応用、そして注意すべきエラーまでを詳しく見てきました。
- 基本構文:
INSERT INTO テーブル (列...) VALUES (値...);が全ての基礎。 - 主キー: 自動採番に設定すれば、IDの管理をデータベースに任せられて安全・確実。
- 複数行INSERT:
VALUES句に複数の値リストをカンマで繋げることで、一括登録が可能。 - INSERT SELECT: 別のテーブルから取得したデータを丸ごと追加できる強力なテクニック。
- エラー対処: 「主キー重複」「NOT NULL違反」「データ型不一致」が三大エラー。原因を理解すれば怖くない。
INSERT文は、あなたのWebサイトやアプリケーションに命を吹き込み、ユーザーのアクションを記録し、コンテンツを豊かにするための最初のステップです。この記事の体験コーナーで何度も練習し、データを自由自在に追加する感覚を掴んでください。この小さな成功体験の積み重ねが、あなたを一流のWebクリエーターへと導いてくれるはずです。