MySQLでエラー1062（23000）：重複エントリが発生する原因と解決方法

MySQLで「ERROR 1062 (23000): Duplicate entry」というエラーが発生する主な原因は、ユニークキー（一意制約）が設定されたカラムに対して、すでに存在する値と重複するデータを挿入しようとした場合です。

ユニークキーは、テーブル内で同じ値の組み合わせが存在しないことを保証するための制約です。そのため、制約に違反するINSERT文を実行すると、MySQLはデータの登録を拒否し、このエラーを返します。

以下で、実際にエラーが発生する流れを確認してみましょう。

1. ユニークキー付きのテーブルを作成する

まず、2つのカラムに複合ユニークキーを設定したテーブルを作成します。

mysql> create table DemoTable776 (
    FirstValue int,
    SecondValue int,
    unique key(FirstValue,SecondValue)
);
Query OK, 0 rows affected (0.74 sec)

この例では、FirstValueとSecondValueの組み合わせが一意になるように設定しています。つまり、この2つの値のペアが完全に同じレコードは、テーブル内に1つしか存在できません。

2. データを挿入してエラーを再現する

INSERTコマンドを使ってレコードを追加します。重複しない値であれば正常に登録できますが、重複する値を挿入した時点でエラーが発生します。

mysql> insert into DemoTable776 values(10,20);
Query OK, 1 row affected (0.16 sec)
mysql> insert into DemoTable776 values(10,40);
Query OK, 1 row affected (0.15 sec)
mysql> insert into DemoTable776 values(40,20);
Query OK, 1 row affected (0.26 sec)
mysql> insert into DemoTable776 values(10,20);
ERROR 1062 (23000): Duplicate entry '10-20' for key 'FirstValue'

最初の3つのINSERT文は成功しています。これは、それぞれの値の組み合わせ（10-20、10-40、40-20）が互いに異なるためです。しかし、4つ目のINSERT文で「(10, 20)」を再度挿入しようとすると、1つ目のレコードと組み合わせが重複するため、ERROR 1062 (23000)が発生します。

エラーメッセージ内の「'10-20'」は重複した値の組み合わせを、「key 'FirstValue'」は違反したユニークキーの名前を示しています。

3. 登録されたレコードを確認する

SELECT文でテーブル内の全レコードを表示してみましょう。

mysql> select *from DemoTable776;

実行結果は以下の通りです。

+------------+-------------+
| FirstValue | SecondValue |
+------------+-------------+
| 10         | 20          |
| 10         | 40          |
| 40         | 20          |
+------------+-------------+
3 rows in set (0.00 sec)

エラーが発生した4つ目のINSERT文は実行されていないため、テーブルには3件のレコードのみが登録されていることがわかります。

エラーを回避するためのポイント

このエラーを回避するには、以下の方法が有効です。

INSERT IGNOREを使用する：重複が発生した場合、エラーを無視して処理を続行します。

mysql> insert ignore into DemoTable776 values(10,20);

REPLACE INTOを使用する：重複が発生した場合、既存のレコードを削除して新しいレコードを挿入します。

mysql> replace into DemoTable776 values(10,20);

ON DUPLICATE KEY UPDATEを使用する：重複が発生した場合、既存レコードの値を更新します。

mysql> insert into DemoTable776 values(10,20) 
on duplicate key update FirstValue=10;

挿入前にSELECT文でデータの存在を確認する、あるいはアプリケーション側で重複チェックを行うことも、エラー防止に役立ちます。