// Référence des erreurs SQL Server

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
Message d'erreur
Violation of %ls constraint '%.*ls'. Cannot insert duplicate key in object '%.*ls'. The duplicate key value is %ls.

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_INSERT activé, 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

  1. Trouvez la ligne existante en utilisant la valeur indiquée dans le message.

    SELECT * FROM dbo.Customers WHERE Email = N'[email protected]';
  2. 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);
  3. Cherchez les doublons dans la source avant l'insertion.

    SELECT Email, COUNT(*) FROM staging.Customers GROUP BY Email HAVING COUNT(*) > 1;
  4. 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;
  5. 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

Plus d'erreurs de contraintes et de clés

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.

// moins d'erreurs, corrections plus rapides

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.