Ошибка MySQL 1062: Дублирование записи для ключа
INSERT или UPDATE попытаются записать уже существующее значение в индекс PRIMARY KEY или UNIQUE. В сообщении названы значение и ключ.
- Номер ошибки
1062- Имя
ER_DUP_ENTRY- SQLSTATE
23000- Категория
- Ключи и ограничения
Что это значит
MySQL отклоняет строку, если значение в первичном ключе или уникальном индексе совпадает со строкой, которая уже существует. Сообщение показывает дублирующее значение и индекс, например Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 и позже включают имя таблицы в ключ).
С многострочным INSERT, строки до дубликата сохраняются в нетранзакционных таблицах, таких как MyISAM, но в InnoDB откатывается вся инструкция.
Распространённые причины
- Повторный запуск скрипта импорта или инициализации, который вставляет строки, уже существующие в таблице.
- Вставка явного идентификатора, который уже существует, или
AUTO_INCREMENTсчетчика, который был установлен ниже текущего максимума. - Вот
UPDATEкоторый изменяет уникальный столбец на значение, которое уже есть в другой строке. - Уникальный индекс на столбец с регистронезависимой сортировкой:
[email protected]и[email protected]считаются одинаковыми.
Как исправить
-
Посмотрите на строку, которая уже содержит это значение.
SELECT * FROM users WHERE email = '[email protected]';
-
Чтобы обновить существующую строку вместо этого, используйте
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; -
Чтобы намеренно пропустить дубликаты, используйте
INSERT IGNORE. Это превращает ошибку в предупреждение — как и некоторые другие, — так что проверьтеSHOW WARNINGSпосле этого.INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada'); -
Если дубликат находится на
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; Перечисляет индексы и их столбцы.
Связанные ошибки
1452Ошибка внешнего ключа: невозможно добавить дочернюю строку1048Столбец не может быть NULL1586Повторяющаяся запись для ключа (с именем ключа)23505PostgreSQL: дублирующий ключ нарушает ограничение уникальности2627SQL Server: нарушение ограничений PRIMARY KEY или UNIQUE KEYORA-00001Oracle: нарушение уникального ограниченияSQLITE_CONSTRAINT_UNIQUESQLite: нарушено ограничение UNIQUE
Больше ошибок ключей и ограничений
1061Повторяющееся имя ключа1451Ошибка внешнего ключа: невозможно удалить родительскую строку1216Невозможно добавить или обновить дочернюю строку1217Невозможно удалить или обновить родительскую строку1215Невозможно добавить ограничение внешнего ключа3780Столбцы внешнего ключа несовместимы1822Отсутствует индекс для ограничения внешнего ключа1824Не удалось открыть ссылочную таблицу
Код и текст сообщения взяты из Справочник сообщений об ошибках MySQL 8.4. Смотрите весь Список ошибок MySQL или поиск по всем ошибкам баз данных.
Работа с MySQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для MySQL и других баз данных, которые вы используете.