SQLITE_CONSTRAINT: нарушено ограничение
INSERT или UPDATE нарушил ограничение: UNIQUE, PRIMARY KEY, NOT NULL, CHECK или FOREIGN KEY. Сообщение и расширенный код указывают, какое именно.
- Код результата
SQLITE_CONSTRAINT- Имя
19- Категория
- Основные коды результатов
Что это значит
SQLITE_CONSTRAINT (19) означает, что оператор нарушил одно из правил таблицы, и SQLite остановил его. Общий текст — constraint failed, но сообщение обычно указывает правило и столбец, например UNIQUE constraint failed: users.email, а расширенный код показывает тип нарушения: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (STRICT-таблицы) или _TRIGGER ( RAISE() в триггере).
По умолчанию сбойный оператор откатывается (режим конфликта ABORT), но предыдущие операторы в той же транзакции сохраняются.
Распространённые причины
- Дублирующее значение в столбце первичного ключа или уникальном столбце.
- NULL в столбце
NOT NULL, часто потому, что при вставке столбец был пропущен и у него нет значения по умолчанию. - Значение, которое нарушает
CHECKвыражение. - Дочерняя строка, у которой нет родителя, с
PRAGMA foreign_keys = ON. - Значение неправильного типа в
STRICTтаблице.
Как исправить
-
Прочтите сообщение или расширенный код, чтобы узнать, какое ограничение не выполнено, затем просмотрите определение таблицы.
SELECT sql FROM sqlite_schema WHERE name = 'users';
-
Дубликаты, которые нужно объединить или пропустить, обрабатывайте через upsert или конфликтное условие.
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
Для остальных ограничений исправьте записываемые данные: укажите недостающее значение, сначала вставьте родительскую строку или исправьте значение, не проходящее проверку.
Связанные ошибки
SQLITE_CONSTRAINT_UNIQUEНарушено ограничение UNIQUESQLITE_CONSTRAINT_PRIMARYKEYНарушено ограничение PRIMARY KEYSQLITE_CONSTRAINT_NOTNULLНарушено ограничение NOT NULLSQLITE_CONSTRAINT_CHECKНарушено ограничение CHECKSQLITE_CONSTRAINT_FOREIGNKEYНарушено ограничение внешнего ключаSQLITE_CONSTRAINT_DATATYPEзначение не соответствует столбцу STRICT
Больше ошибок основных кодов результатов
SQLITE_ERRORОшибка логики SQLSQLITE_PERMдоступ запрещёнSQLITE_ABORTзапрос прерванSQLITE_BUSYбаза данных заблокированаSQLITE_LOCKEDтаблица базы данных заблокированаSQLITE_NOMEMнедостаточно памятиSQLITE_READONLYпопытка записи в базу данных, доступную только для чтенияSQLITE_INTERRUPTпрервано
Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.
Работа с SQLite в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.