// Referencia de errores de SQLite

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

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 UPDATE que asigna a la columna un valor que otra fila ya tiene.

Cómo solucionarlo

  1. Encontrar la fila existente.

    SELECT * FROM users WHERE email = '[email protected]';
  2. 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;
  3. 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

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.