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

SQLITE_CONSTRAINT: нарушено ограничение

INSERT или UPDATE нарушил ограничение: UNIQUE, PRIMARY KEY, NOT NULL, CHECK или FOREIGN KEY. Сообщение и расширенный код указывают, какое именно.

Код результата
SQLITE_CONSTRAINT
Имя
19
Категория
Основные коды результатов
Сообщение об ошибке
constraint failed

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

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 таблице.

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

  1. Прочтите сообщение или расширенный код, чтобы узнать, какое ограничение не выполнено, затем просмотрите определение таблицы.

    SELECT sql FROM sqlite_schema WHERE name = 'users';
  2. Дубликаты, которые нужно объединить или пропустить, обрабатывайте через upsert или конфликтное условие.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. Для остальных ограничений исправьте записываемые данные: укажите недостающее значение, сначала вставьте родительскую строку или исправьте значение, не проходящее проверку.

Связанные ошибки

Больше ошибок основных кодов результатов

Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

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

Работа с SQLite в SQLly

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