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

SQLITE_CONSTRAINT_UNIQUE: нарушено ограничение UNIQUE

INSERT или UPDATE привели бы к дублированию значения в столбце с ограничением UNIQUE или уникальном индексе. Сообщение указывает таблицу и столбец.

Код результата
SQLITE_CONSTRAINT_UNIQUE
Имя
2067
Категория
Расширенные коды результатов
Сообщение об ошибке
UNIQUE constraint failed: users.email

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

SQLite возвращает SQLITE_CONSTRAINT_UNIQUE (2067), когда запись привела бы к созданию двух строк с одинаковым значением в UNIQUE ограничении или уникальном индексе. Сообщение перечисляет столбцы, table.column, через запятую для составного ключа. Дубликаты первичных ключей сообщаются с SQLITE_CONSTRAINT_PRIMARYKEY но текст сообщения у них один и тот же.

NULL не считаются дубликатами: уникальный столбец может содержать любое количество NULL.

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

  • Вставка строки, которая уже существует, например, повторный запуск импорта.
  • Два значения, которые различаются только регистром в колонке, объявленной COLLATE NOCASE.
  • Вот UPDATE который ставит в столбец значение, которое уже есть у другой строки.

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

  1. Найдите существующую строку.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Вместо этого обновите существующую строку с помощью upsert (SQLite 3.24 и новее).

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. Или пропускайте дубликаты намеренно.

    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. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

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

Работа с SQLite в SQLly

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