SQLITE_CONSTRAINT_UNIQUE: нарушено ограничение UNIQUE
INSERT или UPDATE привели бы к дублированию значения в столбце с ограничением UNIQUE или уникальном индексе. Сообщение указывает таблицу и столбец.
- Код результата
SQLITE_CONSTRAINT_UNIQUE- Имя
2067- Категория
- Расширенные коды результатов
Что это значит
SQLite возвращает SQLITE_CONSTRAINT_UNIQUE (2067), когда запись привела бы к созданию двух строк с одинаковым значением в UNIQUE ограничении или уникальном индексе. Сообщение перечисляет столбцы, table.column, через запятую для составного ключа. Дубликаты первичных ключей сообщаются с SQLITE_CONSTRAINT_PRIMARYKEY но текст сообщения у них один и тот же.
NULL не считаются дубликатами: уникальный столбец может содержать любое количество NULL.
Распространённые причины
- Вставка строки, которая уже существует, например, повторный запуск импорта.
- Два значения, которые различаются только регистром в колонке, объявленной
COLLATE NOCASE. - Вот
UPDATEкоторый ставит в столбец значение, которое уже есть у другой строки.
Как исправить
-
Найдите существующую строку.
SELECT * FROM users WHERE email = '[email protected]';
-
Вместо этого обновите существующую строку с помощью upsert (SQLite 3.24 и новее).
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
Или пропускайте дубликаты намеренно.
INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
Безопасное воспроизведение
CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x'); -- Runtime error: UNIQUE constraint failed: users.email (19)
Вопросы
В чем разница между INSERT OR REPLACE и upsert?
INSERT OR REPLACE удаляет конфликтующую строку и вставляет новую, так что столбцы, которые вы не указали, сбрасываются, и триггеры удаления и действия внешнего ключа могут сработать. Upsert с ON CONFLICT DO UPDATE изменяет существующую строку на месте.
Связанные ошибки
SQLITE_CONSTRAINT_PRIMARYKEYНарушено ограничение PRIMARY KEYSQLITE_CONSTRAINTнарушение ограничения23505PostgreSQL: дублирующий ключ нарушает ограничение уникальности1062MySQL: Дублирующая запись для ключа2627SQL Server: нарушение ограничений PRIMARY KEY или UNIQUE KEY2601SQL Server: не удалось вставить строку с повторяющимся ключомORA-00001Oracle: нарушение уникального ограничения
Больше ошибок расширенных кодов результатов
SQLITE_ERROR_MISSING_COLLSEQнет такой последовательности сортировкиSQLITE_BUSY_RECOVERYдругой процесс восстанавливает WALSQLITE_LOCKED_SHAREDCACHEзапись заблокирована в общем кэшеSQLITE_CONSTRAINT_CHECKНарушено ограничение CHECKSQLITE_ABORT_ROLLBACKоператор прерван командой ROLLBACKSQLITE_BUSY_SNAPSHOTустаревшее чтение не может стать записьюSQLITE_IOERR_SHORT_READчтение вернуло меньше байтSQLITE_CANTOPEN_ISDIRпуть является каталогом
Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.
Работа с SQLite в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.