SQLITE_CONSTRAINT_UNIQUE: Falló la restricción UNIQUE
Un INSERT o UPDATE duplicaría un valor en una columna UNIQUE o un índice único. El mensaje nombra la tabla y la columna.
- Código de resultado
SQLITE_CONSTRAINT_UNIQUE- Nombre
2067- Categoría
- Códigos de resultado extendidos
Qué significa
SQLite devuelve SQLITE_CONSTRAINT_UNIQUE (2067) cuando una escritura crearía dos filas con el mismo valor en una UNIQUE restricción o índice único. El mensaje lista las columnas, como table.column, separadas por comas en una clave de varias columnas. Las claves primarias duplicadas se señalan con SQLITE_CONSTRAINT_PRIMARYKEY pero usan el mismo texto de mensaje.
Los NULL no cuentan como duplicados: una columna única puede contener cualquier número de NULL.
Causas comunes
- Insertar una fila que ya existe, por ejemplo al volver a ejecutar una importación.
- Dos valores que difieren solo en mayúsculas y minúsculas, en una columna declarada
COLLATE NOCASE. - Una
UPDATEque asigna a la columna un valor que otra fila ya tiene.
Cómo solucionarlo
-
Encontrar la fila existente.
SELECT * FROM users WHERE email = '[email protected]';
-
En su lugar, actualiza la fila existente con un upsert (SQLite 3.24 o posterior).
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
O salta los duplicados a propósito.
INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
Reprodúcelo de forma segura
CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x'); -- Runtime error: UNIQUE constraint failed: users.email (19)
Preguntas
¿Cuál es la diferencia entre INSERT OR REPLACE y un upsert?
INSERT OR REPLACE elimina la fila en conflicto e inserta una nueva, así que las columnas que no indicaste se restablecen y pueden ejecutarse disparadores de borrado y acciones de clave foránea. Un upsert con ON CONFLICT DO UPDATE modifica la fila existente directamente.
Errores relacionados
SQLITE_CONSTRAINT_PRIMARYKEYFalló la restricción de PRIMARY KEYSQLITE_CONSTRAINTrestricción fallida23505PostgreSQL: la clave duplicada infringe la restricción de unicidad1062MySQL: entrada duplicada para la clave2627SQL Server: Infracción de PRIMARY KEY o UNIQUE KEY2601SQL Server: No se puede insertar una fila con clave duplicadaORA-00001Oracle: restricción de unicidad violada
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.