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

SQLITE_CONSTRAINT_NOTNULL: нарушено ограничение NOT NULL

INSERT или UPDATE попытались записать NULL в столбец NOT NULL, обычно потому, что столбец пропущен и не имеет значения по умолчанию. В сообщении он назван.

Код результата
SQLITE_CONSTRAINT_NOTNULL
Имя
1299
Категория
Расширенные коды результатов
Сообщение об ошибке
NOT NULL constraint failed: users.name

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

SQLITE_CONSTRAINT_NOTNULL (1299) означает, что NOT NULL столбец получил бы NULL. Это происходит, когда вы передаёте NULL явно, а также когда INSERT не включает NOT NULL столбца, у которого нет DEFAULT, потому что отсутствующий столбец получает NULL.

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

  • Этот INSERT список столбцов пропускает обязательный столбец без значения по умолчанию.
  • Приложение передало NULL или None вместо значения, которого у него не было.
  • Добавление NOT NULL столбец при перестроении таблицы, не заполняя его для существующих строк.

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

  1. Укажите значение для столбца или задайте ему значение по умолчанию.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada');
  2. Проверьте, какие столбцы являются обязательными.

    PRAGMA table_info(users);  -- notnull = 1, dflt_value
  3. Чтобы добавить обязательный столбец в готовую таблицу, задайте ему значение по умолчанию — тогда текущие строки его получат.

    ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';

Безопасное воспроизведение

CREATE TABLE users (email TEXT, name TEXT NOT NULL);
INSERT INTO users (email) VALUES ('a@x');  -- Runtime error: NOT NULL constraint failed: users.name (19)

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

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

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

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

Работа с SQLite в SQLly

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