// справочник ошибок MySQL

Ошибка MySQL 1062: Дублирование записи для ключа

INSERT или UPDATE попытаются записать уже существующее значение в индекс PRIMARY KEY или UNIQUE. В сообщении названы значение и ключ.

Номер ошибки
1062
Имя
ER_DUP_ENTRY
SQLSTATE
23000
Категория
Ключи и ограничения
Сообщение об ошибке
Duplicate entry '%s' for key %d

Что это значит

MySQL отклоняет строку, если значение в первичном ключе или уникальном индексе совпадает со строкой, которая уже существует. Сообщение показывает дублирующее значение и индекс, например Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 и позже включают имя таблицы в ключ).

С многострочным INSERT, строки до дубликата сохраняются в нетранзакционных таблицах, таких как MyISAM, но в InnoDB откатывается вся инструкция.

Распространённые причины

  • Повторный запуск скрипта импорта или инициализации, который вставляет строки, уже существующие в таблице.
  • Вставка явного идентификатора, который уже существует, или AUTO_INCREMENT счетчика, который был установлен ниже текущего максимума.
  • Вот UPDATE который изменяет уникальный столбец на значение, которое уже есть в другой строке.
  • Уникальный индекс на столбец с регистронезависимой сортировкой: [email protected] и [email protected] считаются одинаковыми.

Как исправить

  1. Посмотрите на строку, которая уже содержит это значение.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Чтобы обновить существующую строку вместо этого, используйте INSERT ... ON DUPLICATE KEY UPDATE. В MySQL 8.0.19 и более поздних версиях обращайтесь к новым значениям через псевдоним строки; более старые версии используют VALUES(name), который по-прежнему работает, но является устаревшим.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new
    ON DUPLICATE KEY UPDATE name = new.name;
  3. Чтобы намеренно пропустить дубликаты, используйте INSERT IGNORE. Это превращает ошибку в предупреждение — как и некоторые другие, — так что проверьте SHOW WARNINGS после этого.

    INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
  4. Если дубликат находится на AUTO_INCREMENT, сверьте счётчик с данными.

    SELECT MAX(id) FROM users;
    SHOW CREATE TABLE users;  -- shows AUTO_INCREMENT=n

Безопасное воспроизведение

CREATE TEMPORARY TABLE t (id INT PRIMARY KEY);
INSERT INTO t VALUES (1);
INSERT INTO t VALUES (1);  -- ERROR 1062 (23000): Duplicate entry '1' for key 't.PRIMARY'

Вопросы

Как определить, на каком ключе дубликат?

Сообщение называет его: for key 'PRIMARY' — первичный ключ, всё остальное — имя уникального индекса. SHOW INDEX FROM table_name; Перечисляет индексы и их столбцы.

Связанные ошибки

Больше ошибок ключей и ограничений

Код и текст сообщения взяты из Справочник сообщений об ошибках MySQL 8.4. Смотрите весь Список ошибок MySQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с MySQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для MySQL и других баз данных, которые вы используете.