// Referencia de errores de SQLite

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
Mensaje de error
constraint failed

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 CHECK expresión.
  • Una fila hija cuyo padre no existe, con PRAGMA foreign_keys = ON.
  • Un valor del tipo incorrecto en una STRICT tabla.

Cómo solucionarlo

  1. 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';
  2. 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;
  3. 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

Más errores de códigos de resultado principales

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.

// menos errores, correcciones más rápidas

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.