SQL Duplicate entry ‘…’ for key ‘PRIMARY’ の原因と解決方法

Duplicate entry ‘…’ for key ‘PRIMARY’ とは

SQLで『Duplicate entry ‘…’ for key ‘PRIMARY’』エラーは、テーブルの主キー（PRIMARY KEY）や一意制約（UNIQUE KEY）が設定されたカラムに、既に存在する値を挿入または更新しようとしたときに発生します。このエラーはデータの整合性を保つために非常に重要であり、不適切なデータ挿入を防ぎます。原因を特定し、適切なSQL操作を行うことで、データ管理の信頼性を高めることができます。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: パターン1: 既存の主キー値を持つレコードを挿入しようとする

-- テーブルの作成（idがPRIMARY KEY）
CREATE TABLE products (
    id INT PRIMARY KEY,
    name VARCHAR(255)
);

-- 最初の挿入は成功
INSERT INTO products (id, name) VALUES (1, 'Laptop');

-- 2回目の挿入で同じid (1) を使用しようとする（エラー発生）
INSERT INTO products (id, name) VALUES (1, 'Mouse');

idカラムが主キーとして設定されているため、テーブル内の各id値は一意である必要があります。すでにid=1のレコードが存在する状態で、再度id=1のレコードを挿入しようとすると、主キーの重複エラーが発生します。

-- 異なる主キー値で挿入する
INSERT INTO products (id, name) VALUES (2, 'Mouse');

パターン2: パターン2: オートインクリメントを使わず、手動で重複したIDを挿入

-- テーブルの作成（idがPRIMARY KEY）
CREATE TABLE users (
    id INT PRIMARY KEY,
    username VARCHAR(50) UNIQUE
);

INSERT INTO users (id, username) VALUES (101, 'john_doe');

-- 次の挿入で、手動で設定したidが既存のidと重複
INSERT INTO users (id, username) VALUES (101, 'jane_doe');

このケースでは、主キーidにオートインクリメントが設定されていません。そのため、挿入時に手動でidの値を指定する必要があります。開発者が誤って既存のid値と同じものを指定すると、重複エラーが発生します。 また、usernameにもUNIQUE制約があるため、そちらでも重複エラーが発生する可能性があります。

-- 異なる主キー値で挿入する
INSERT INTO users (id, username) VALUES (102, 'jane_doe');

-- または、オートインクリメントを使用する（推奨）
-- ALTER TABLE users MODIFY id INT AUTO_INCREMENT PRIMARY KEY;
-- INSERT INTO users (username) VALUES ('new_user'); -- idは自動生成される

パターン3: パターン3: UNIQUE制約を持つカラムで重複値を挿入/更新

-- テーブルの作成（emailがUNIQUE制約）
CREATE TABLE customers (
    id INT PRIMARY KEY AUTO_INCREMENT,
    email VARCHAR(255) UNIQUE
);

INSERT INTO customers (email) VALUES ('test@example.com');

-- 同じemailアドレスを挿入しようとする（エラー発生）
INSERT INTO customers (email) VALUES ('test@example.com');

主キーだけでなく、UNIQUE制約が設定されたカラムでも同様の重複エラーが発生します。この例では、emailカラムにUNIQUE制約があるため、同じメールアドレスを持つ複数のレコードを保存することはできません。 これはデータの整合性を保つための重要な制約です。

-- 異なるemailアドレスで挿入する
INSERT INTO customers (email) VALUES ('another@example.com');

-- または、MySQLの場合、ON DUPLICATE KEY UPDATE を使用して更新する
-- INSERT INTO customers (email) VALUES ('test@example.com') ON DUPLICATE KEY UPDATE email = 'test@example.com';

根本原因の特定方法

このエラーが発生した場合、まずエラーメッセージに示された重複している値を確認します。次に、その値が対象のテーブルに既に存在するかをSELECT文で確認します。また、INSERTまたはUPDATE文で指定している値が、意図せず既存の値と重複していないかを検証します。

SELECT * FROM your_table WHERE id = 'duplicate_value_from_error_message';
-- または
SELECT * FROM your_table WHERE unique_column = 'duplicate_value_from_error_message';

防止策とベストプラクティス

主キーにはオートインクリメントを設定し、手動で値を挿入する場合は事前に重複チェックを行うようにしましょう。また、トランザクションを利用して複数の操作をアトミックに実行したり、INSERT ... ON DUPLICATE KEY UPDATE（MySQL）やINSERT ... ON CONFLICT（PostgreSQL）などの構文を活用することも有効です。

-- MySQLの例: 重複があれば更新、なければ挿入
INSERT INTO products (id, name) VALUES (1, 'Updated Laptop')
ON DUPLICATE KEY UPDATE name = 'Updated Laptop';

-- MySQLの例: 重複があれば挿入を無視
INSERT IGNORE INTO products (id, name) VALUES (1, 'New Item');

-- PostgreSQLの例: 重複があれば何もしない
INSERT INTO products (id, name) VALUES (1, 'Laptop')
ON CONFLICT (id) DO NOTHING;

よくある質問（FAQ）