// Referência de erro do SQLite

SQLITE_CONSTRAINT: falha na restrição

Um INSERT ou UPDATE violou uma restrição: UNIQUE, PRIMARY KEY, NOT NULL, CHECK ou FOREIGN KEY. A mensagem e o código estendido dizem qual.

Código de resultado
SQLITE_CONSTRAINT
Nome
19
Categoria
Códigos de resultado primários
Mensagem de erro
constraint failed

O que significa

SQLITE_CONSTRAINT (19) significa que uma instrução teria violado uma das regras da tabela, então o SQLite a interrompeu. O texto genérico é constraint failed, mas a mensagem geralmente cita a regra e a coluna, como UNIQUE constraint failed: users.email, e o código estendido indica o tipo: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (tabelas STRICT) ou _TRIGGER (um RAISE() em um gatilho).

Por padrão, a instrução que falhou é desfeita (modo de conflito ABORT), mas as instruções anteriores na mesma transação são mantidas.

Causas comuns

  • Um valor duplicado em uma chave primária ou coluna única.
  • Um NULL em uma coluna NOT NULL coluna, muitas vezes porque o insert deixou a coluna de fora e ela não tem valor padrão.
  • Um valor que falha em uma CHECK expressão.
  • Uma linha filha cujo pai não existe, com PRAGMA foreign_keys = ON.
  • Um valor do tipo errado em uma STRICT tabela.

Como corrigir

  1. Leia a mensagem ou o código estendido para ver qual restrição falhou, depois verifique a definição da tabela.

    SELECT sql FROM sqlite_schema WHERE name = 'users';
  2. Para duplicatas que você deseja mesclar ou pular, use um upsert ou uma cláusula de conflito.

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. Para as outras restrições, corrija os dados que você está gravando: forneça o valor que falta, insira a linha pai primeiro ou corrija o valor que não passa na verificação.

Erros relacionados

Mais erros de códigos de resultado primário

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.