Erreur SQL Server 2627 : Violation de PRIMARY KEY ou de clé UNIQUE
Un INSERT ou UPDATE dupliquerait une valeur dans une clé primaire ou une contrainte UNIQUE. Le message indique la contrainte, la table et la valeur de clé dupliquée.
- Numéro d'erreur
2627- Sévérité
- 14
- Catégorie
- Contraintes et clés
Ce que cela signifie
Les clés primaires et les contraintes uniques garantissent qu'aucune ligne ne partage la même clé. Lorsqu'une écriture créerait un doublon, SQL Server arrête l'instruction avec 2627, suivie de 3621 (« L'instruction a été interrompue »). Le message indique quel type de contrainte (PRIMARY KEY ou UNIQUE KEY), son nom, la table, et depuis SQL Server 2017 la valeur dupliquée elle-même.
L'erreur 2601 correspond à la même erreur sur un index unique qui n'est pas une contrainte.
Causes courantes
- Insertion d'une ligne dont la clé existe déjà, par exemple lors de la réexécution d'un chargement.
- Insertion de valeurs explicites dans une colonne d'identité avec
IDENTITY_INSERTactivé, ou réinitialisation du seed d'identité en dessous des valeurs existantes. - Une insertion par lot à partir d'une source qui contient elle-même des clés en double.
- Deux sessions insérant simultanément la même clé : le modèle vérifier-puis-insérer (
IF NOT EXISTS ... INSERT) n'est pas sûr sans indices de verrouillage.
Comment le corriger
-
Trouvez la ligne existante en utilisant la valeur indiquée dans le message.
SELECT * FROM dbo.Customers WHERE Email = N'[email protected]';
-
Ignorer les lignes qui existent déjà lors du chargement.
INSERT INTO dbo.Customers (Email, Name) SELECT s.Email, s.Name FROM staging.Customers AS s WHERE NOT EXISTS (SELECT 1 FROM dbo.Customers AS c WHERE c.Email = s.Email);
-
Cherchez les doublons dans la source avant l'insertion.
SELECT Email, COUNT(*) FROM staging.Customers GROUP BY Email HAVING COUNT(*) > 1;
-
Pour un upsert sûr face à la concurrence, mettez à jour d'abord, puis insérez si rien n'a été mis à jour, en maintenant un verrou de plage.
BEGIN TRANSACTION; UPDATE dbo.Customers WITH (UPDLOCK, SERIALIZABLE) SET Name = @Name WHERE Email = @Email; IF @@ROWCOUNT = 0 INSERT INTO dbo.Customers (Email, Name) VALUES (@Email, @Name); COMMIT; -
Si une colonne d'identité entre en collision, vérifiez et réinitialisez-la.
DBCC CHECKIDENT ('dbo.Customers', NORESEED); -- shows current and max values DBCC CHECKIDENT ('dbo.Customers', RESEED);
Reproduisez-le en toute sécurité
CREATE TABLE #k (id int PRIMARY KEY); INSERT INTO #k VALUES (1); INSERT INTO #k VALUES (1); -- Msg 2627 ... The duplicate key value is (1). DROP TABLE #k;
Questions
Quelle est la différence entre l'erreur 2627 et 2601 ?
2627 est renvoyée par une contrainte PRIMARY KEY ou UNIQUE ; 2601 par un index unique créé avec CREATE UNIQUE INDEX. La cause et les corrections sont les mêmes.
Puis-je faire en sorte que SQL Server ignore les clés en double ?
Un index unique créé WITH (IGNORE_DUP_KEY = ON) écarte les lignes en double d'un INSERT avec un avertissement au lieu de faire échouer l'instruction. À utiliser en connaissance de cause, car il supprime des données en silence.
Erreurs liées
2601Impossible d'insérer une ligne de clé en double547Instruction en conflit avec une contrainte515Impossible d'insérer la valeur NULL dans la colonne23505PostgreSQL : la clé en double viole la contrainte d'unicité1062MySQL : Entrée en double pour la cléORA-00001Oracle : contrainte unique violéeSQLITE_CONSTRAINT_PRIMARYKEYSQLite : échec de la contrainte PRIMARY KEY
Plus d'erreurs de contraintes et de clés
3726Impossible de supprimer : référencé par une clé étrangère1913Nom d'index ou de statistique déjà utilisé1750Impossible de créer la contrainte ou l'index4712Impossible de tronquer une table référencée1505Clé dupliquée trouvée, index unique
Le code et le texte du message sont issus de Référence des événements et erreurs du moteur de base de données Microsoft. Parcourir la liste complète Liste des erreurs de SQL Server ou Rechercher toutes les erreurs de base de données.
Travailler sur SQL Server 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 SQL Server et les autres bases de données que vous utilisez.