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
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 NULLcoluna, muitas vezes porque o insert deixou a coluna de fora e ela não tem valor padrão. - Um valor que falha em uma
CHECKexpressão. - Uma linha filha cujo pai não existe, com
PRAGMA foreign_keys = ON. - Um valor do tipo errado em uma
STRICTtabela.
Como corrigir
-
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';
-
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; -
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
SQLITE_CONSTRAINT_UNIQUEfalha na restrição UNIQUESQLITE_CONSTRAINT_PRIMARYKEYfalha na restrição de CHAVE PRIMÁRIASQLITE_CONSTRAINT_NOTNULLFalha na restrição NOT NULLSQLITE_CONSTRAINT_CHECKfalha na restrição CHECKSQLITE_CONSTRAINT_FOREIGNKEYFalha na restrição de chave estrangeiraSQLITE_CONSTRAINT_DATATYPEo valor não cabe em uma coluna STRICT
Mais erros de códigos de resultado primário
SQLITE_ERRORErro de lógica SQLSQLITE_PERMpermissão de acesso negadaSQLITE_ABORTconsulta abortadaSQLITE_BUSYo banco de dados está bloqueadoSQLITE_LOCKEDa tabela do banco de dados está bloqueadaSQLITE_NOMEMsem memóriaSQLITE_READONLYtentativa de escrever em um banco de dados somente leituraSQLITE_INTERRUPTinterrompido
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.
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.