// Referencia de errores de SQLite

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
Mensaje de error
UNIQUE constraint failed: orders.id

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

  1. Dejar que SQLite asigne INTEGER PRIMARY KEY valores dejando fuera la columna.

    INSERT INTO orders (customer_id, total) VALUES (42, 19.99);
    SELECT last_insert_rowid();
  2. 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

Más errores de códigos de resultado extendidos

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.