// Référence des erreurs SQLite

SQLITE_CONSTRAINT_UNIQUE : échec de la contrainte UNIQUE

Un INSERT ou UPDATE dupliquerait une valeur dans une colonne UNIQUE ou un index unique. Le message indique le nom de la table et de la colonne.

Code de résultat
SQLITE_CONSTRAINT_UNIQUE
Nom
2067
Catégorie
Codes de résultat étendus
Message d'erreur
UNIQUE constraint failed: users.email

Ce que cela signifie

SQLite renvoie SQLITE_CONSTRAINT_UNIQUE (2067) lorsqu'une écriture créerait deux lignes avec la même valeur dans une UNIQUE contrainte ou un index unique. Le message liste les colonnes, comme table.column, séparées par des virgules pour une clé multi-colonnes. Les clés primaires dupliquées sont signalées avec SQLITE_CONSTRAINT_PRIMARYKEY mais utilisent le même texte de message.

Les NULL ne comptent pas comme des doublons : une colonne unique peut contenir autant de NULL que l'on veut.

Causes courantes

  • Insertion d'une ligne qui existe déjà, par exemple en réexécutant une importation.
  • Deux valeurs qui ne diffèrent que par la casse, dans une colonne déclarée COLLATE NOCASE.
  • Une UPDATE qui met la colonne à une valeur qu'une autre ligne possède déjà.

Comment le corriger

  1. Trouvez la ligne existante.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Mettez plutôt à jour la ligne existante, avec un upsert (SQLite 3.24 et versions ultérieures).

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. Ou ignorez volontairement les doublons.

    INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');

Reproduisez-le en toute sécurité

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)

Questions

Quelle est la différence entre INSERT OR REPLACE et un upsert ?

INSERT OR REPLACE supprime la ligne en conflit et en insère une nouvelle, donc les colonnes que vous n'avez pas fournies sont réinitialisées et les déclencheurs de suppression ainsi que les actions de clés étrangères peuvent se déclencher. Un upsert avec ON CONFLICT DO UPDATE modifie la ligne existante sur place.

Erreurs liées

Plus de codes d'erreurs de résultat étendus

Le code et le texte du message sont issus de documentation des codes de résultat et d'erreur SQLite. Parcourir la liste complète Liste des erreurs SQLite ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur SQLite dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour SQLite et les autres bases de données que vous utilisez.