SQLITE_CONSTRAINT: Falló la restricción
Un INSERT o UPDATE violó una restricción: UNIQUE, PRIMARY KEY, NOT NULL, CHECK o FOREIGN KEY. El mensaje y el código extendido indican cuál.
- Código de resultado
SQLITE_CONSTRAINT- Nombre
19- Categoría
- Códigos de resultado primarios
Qué significa
SQLITE_CONSTRAINT (19) significa que una instrucción habría violado una de las reglas de la tabla, así que SQLite la detuvo. El texto genérico es constraint failed, pero el mensaje normalmente menciona la regla y la columna, como UNIQUE constraint failed: users.email, y el código extendido te indica el tipo: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (tablas STRICT) o _TRIGGER (un RAISE() en un trigger).
Por defecto, la instrucción que falla se revierte (modo de conflicto ABORT) pero las instrucciones anteriores en la misma transacción se conservan.
Causas comunes
- Un valor duplicado en una clave primaria o columna única.
- Un NULL en una columna
NOT NULL, a menudo porque la inserción omitió la columna y esta no tiene valor por defecto. - Un valor que no cumple una
CHECKexpresión. - Una fila hija cuyo padre no existe, con
PRAGMA foreign_keys = ON. - Un valor del tipo incorrecto en una
STRICTtabla.
Cómo solucionarlo
-
Lee el mensaje o el código extendido para ver qué restricción falló y luego mira la definición de la tabla.
SELECT sql FROM sqlite_schema WHERE name = 'users';
-
Para duplicados que quieres combinar o omitir, usa un upsert o una cláusula de conflicto.
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
Para las otras restricciones, corrige los datos que estás escribiendo: proporciona el valor faltante, inserta primero la fila padre o corrige el valor que falla en la comprobación.
Errores relacionados
SQLITE_CONSTRAINT_UNIQUEFalló la restricción UNIQUESQLITE_CONSTRAINT_PRIMARYKEYFalló la restricción de PRIMARY KEYSQLITE_CONSTRAINT_NOTNULLSe violó la restricción NOT NULLSQLITE_CONSTRAINT_CHECKfallo en la restricción CHECKSQLITE_CONSTRAINT_FOREIGNKEYSe violó la restricción FOREIGN KEYSQLITE_CONSTRAINT_DATATYPEel valor no cabe en una columna STRICT
Más errores de códigos de resultado principales
SQLITE_ERRORError de lógica SQLSQLITE_PERMpermiso de acceso denegadoSQLITE_ABORTconsulta abortadaSQLITE_BUSYla base de datos está bloqueadaSQLITE_LOCKEDla tabla de la base de datos está bloqueadaSQLITE_NOMEMmemoria agotadaSQLITE_READONLYintento de escribir en una base de datos de solo lecturaSQLITE_INTERRUPTinterrumpido
El código y el texto del mensaje son de Documentación de los códigos de resultado y de error de SQLite. Explora la lista completa de Lista de errores de SQLite o buscar cada error de base de datos.
Trabajar con SQLite en SQLly
Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para SQLite y las demás bases de datos que uses.