PostgreSQL 23505: дублирующий ключ нарушает ограничение уникальности
INSERT или UPDATE создаст вторую строку с тем же значением в столбце, на который распространяется первичный ключ, уникальное ограничение или уникальный индекс.
- SQLSTATE
23505- Имя
unique_violation- Категория
- Нарушение ограничения целостности
Что это значит
PostgreSQL следит за каждым первичным ключом, UNIQUE ограничение и уникальный индекс в момент записи строки. Если новая или изменённая строка имеет тот же ключ, что и уже существующая строка (или та, которую написала другая транзакция, но ещё не зафиксировала), операция завершается с ошибкой 23505, и ничего не изменяется.
Этот DETAIL строка называет столбец и повторяющееся значение, а сообщение — ограничение или индекс, так что сразу ясно, какое правило нарушено.
Распространённые причины
- Вставка строки, ключ которой уже существует, например повторный запуск импорта или скрипта заполнения данных.
- A
serialили последовательность identity, отставшую от данных, — обычно после загрузки строк с явно заданными id. Следующий id по умолчанию конфликтует с существующей строкой: классическийKey (id)=(1) already exists. - Две сессии вставляют один и тот же ключ одновременно; вторая ожидает первую и завершается с ошибкой, как только первая подтверждает изменения.
- Вот
UPDATEкоторый ставит в уникальный столбец значение, которое уже есть у другой строки.
Как исправить
-
Найдите существующую строку, указанную в
DETAILстроке и решите, являются ли новые данные дубликатом или другой записью.SELECT * FROM users WHERE email = '[email protected]';
-
Если запись должна вместо этого обновить существующую строку, превратите её в upsert с помощью
ON CONFLICT.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name; -
Если дубликаты следует просто пропускать, используйте
ON CONFLICT DO NOTHING.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO NOTHING; -
Если дубликат находится на
serialили identity-id, сдвиньте последовательность за максимальное существующее значение.SELECT setval(pg_get_serial_sequence('users', 'id'), (SELECT COALESCE(MAX(id), 0) + 1 FROM users), false);
Безопасное воспроизведение
CREATE TEMP TABLE t (id int PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ERROR: duplicate key value violates unique constraint "t_pkey"
Вопросы
Почему вставка завершается ошибкой дубликата ключа в столбце id, если я не задавал id?
Последовательность таблицы отстаёт от данных — обычно строки вставлялись с явными id или восстанавливались без значения последовательности. Сбросьте её с помощью setval на единицу дальше MAX(id).
Работает ли ON CONFLICT с любым уникальным индексом?
Он работает со столбцами уникального индекса или ограничения, или с ON CONFLICT ON CONSTRAINT name. Требуется PostgreSQL 9.5 или новее.
Связанные ошибки
23503нарушение ограничения внешнего ключа23502значение null нарушает ограничение not-null25P02текущая транзакция прервана2627SQL Server: нарушение ограничений PRIMARY KEY или UNIQUE KEY2601SQL Server: не удалось вставить строку с повторяющимся ключом1062MySQL: Дублирующая запись для ключаORA-00001Oracle: нарушение уникального ограниченияSQLITE_CONSTRAINT_UNIQUESQLite: нарушено ограничение UNIQUE
Больше ошибок нарушения ограничений целостности
Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.
Работа с PostgreSQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.