SQLITE_CONSTRAINT_PRIMARYKEY: Falló la restricción PRIMARY KEY
Un INSERT o UPDATE duplicaría un valor de clave primaria. El mensaje de SQLite sigue diciendo «UNIQUE constraint failed» y nombra la columna de la clave.
- Código de resultado
SQLITE_CONSTRAINT_PRIMARYKEY- Nombre
1555- Categoría
- Códigos de resultado extendidos
Qué significa
SQLITE_CONSTRAINT_PRIMARYKEY (1555) es el código extendido para una clave primaria duplicada. El texto del mensaje es el mismo que para cualquier violación de UNIQUE, UNIQUE constraint failed: table.column, así que el código extendido es como un programa distingue uno de otro.
Para un INTEGER PRIMARY KEY columna puedes omitir el valor (o pasar NULL) y SQLite asigna el siguiente rowid, lo que evita la mayoría de las colisiones.
Causas comunes
- Insertar un id explícito que ya existe.
- Copiando filas entre bases de datos con sus ids, donde los rangos se superponen.
- Generando ids en la aplicación con un esquema que puede repetirse.
Cómo solucionarlo
-
Dejar que SQLite asigne
INTEGER PRIMARY KEYvalores dejando fuera la columna.INSERT INTO orders (customer_id, total) VALUES (42, 19.99); SELECT last_insert_rowid();
-
Al fusionar datos, haz upsert sobre la clave u omite las filas existentes.
INSERT INTO orders (id, customer_id, total) SELECT id, customer_id, total FROM other.orders WHERE true ON CONFLICT (id) DO NOTHING;
Errores relacionados
SQLITE_CONSTRAINT_UNIQUEFalló la restricción UNIQUESQLITE_MISMATCHincompatibilidad de tipos de datosSQLITE_CONSTRAINTrestricción fallida23505PostgreSQL: la clave duplicada infringe la restricción de unicidad1062MySQL: entrada duplicada para la clave
Más errores de códigos de resultado extendidos
SQLITE_ERROR_MISSING_COLLSEQno existe la secuencia de intercalaciónSQLITE_BUSY_RECOVERYotro proceso está recuperando el WALSQLITE_LOCKED_SHAREDCACHEregistro bloqueado en la caché compartidaSQLITE_CONSTRAINT_CHECKfallo en la restricción CHECKSQLITE_ABORT_ROLLBACKinstrucción abortada por ROLLBACKSQLITE_BUSY_SNAPSHOTuna lectura obsoleta no puede convertirse en escrituraSQLITE_IOERR_SHORT_READla lectura devolvió menos bytesSQLITE_CANTOPEN_ISDIRla ruta es un directorio
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.