// Referência de erro do SQLite

SQLITE_CONSTRAINT_NOTNULL: falha na restrição NOT NULL

Um INSERT ou UPDATE tentou guardar NULL em uma coluna NOT NULL, geralmente porque a coluna foi deixada de fora e não tem padrão. A mensagem a identifica.

Código de resultado
SQLITE_CONSTRAINT_NOTNULL
Nome
1299
Categoria
Códigos de resultado estendidos
Mensagem de erro
NOT NULL constraint failed: users.name

O que significa

SQLITE_CONSTRAINT_NOTNULL (1299) significa que uma NOT NULL coluna teria recebido NULL. Isso acontece quando você passa NULL explicitamente, e também quando um INSERT omite uma NOT NULL coluna que não tem DEFAULT, porque a coluna ausente recebe NULL.

Causas comuns

  • O INSERT a lista de colunas omite uma coluna obrigatória sem valor padrão.
  • O aplicativo passou NULL ou None para um valor que não possuía.
  • Adicionando uma NOT NULL coluna em uma reconstrução de tabela sem preenchê-la para as linhas existentes.

Como corrigir

  1. Forneça um valor para a coluna, ou dê a ela um valor padrão.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada');
  2. Verifique quais colunas são obrigatórias.

    PRAGMA table_info(users);  -- notnull = 1, dflt_value
  3. Para adicionar uma coluna obrigatória a uma tabela existente, dê a ela um valor padrão para que as linhas existentes recebam um valor.

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

Reproduza com segurança

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)

Erros relacionados

Mais erros de códigos de resultado estendidos

O código e o texto da mensagem são de Documentação de códigos de resultado e erro do SQLite. Veja toda a Lista de erros do SQLite ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQLite no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQLite e os outros bancos de dados que você usa.