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
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
UPDATEqui met la colonne à une valeur qu'une autre ligne possède déjà.
Comment le corriger
-
Trouvez la ligne existante.
SELECT * FROM users WHERE email = '[email protected]';
-
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; -
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
SQLITE_CONSTRAINT_PRIMARYKEYÉchec de la contrainte de clé primaireSQLITE_CONSTRAINTéchec de contrainte23505PostgreSQL : la clé en double viole la contrainte d'unicité1062MySQL : Entrée en double pour la clé2627SQL Server : violation de la contrainte PRIMARY KEY ou UNIQUE KEY2601SQL Server : Impossible d'insérer une ligne avec une clé en doubleORA-00001Oracle : contrainte unique violée
Plus de codes d'erreurs de résultat étendus
SQLITE_ERROR_MISSING_COLLSEQaucune séquence de tri de ce typeSQLITE_BUSY_RECOVERYun autre processus est en train de récupérer le WALSQLITE_LOCKED_SHAREDCACHEenregistrement verrouillé dans le cache partagéSQLITE_CONSTRAINT_CHECKcontrainte CHECK échouéeSQLITE_ABORT_ROLLBACKinstruction annulée par ROLLBACKSQLITE_BUSY_SNAPSHOTlecture obsolète ne peut pas devenir une écritureSQLITE_IOERR_SHORT_READlecture a renvoyé moins d’octetsSQLITE_CANTOPEN_ISDIRle chemin est un répertoire
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.
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.