// Référence des erreurs SQL Server

Erreur SQL Server 2601 : Impossible d'insérer une ligne avec une clé en double

Un INSERT ou UPDATE mettrait une valeur en double dans un index unique. Le message indique le nom de la table, l'index et la valeur de clé en double.

Numéro d'erreur
2601
Sévérité
14
Catégorie
Contraintes et clés
Message d'erreur
Cannot insert duplicate key row in object '%.*ls' with unique index '%.*ls'. The duplicate key value is %ls.

Ce que cela signifie

L'erreur 2601 est générée par un index unique créé avec CREATE UNIQUE INDEX, y compris les index uniques filtrés. C'est l'équivalent, pour les index, de l'erreur 2627, qui provient des contraintes de PRIMARY KEY et UNIQUE. L'instruction s'arrête et ses modifications sont annulées.

Causes courantes

  • Écriture d'une valeur qu'une autre ligne possède déjà dans une colonne couverte par un index unique.
  • Un index unique sur une colonne pouvant contenir des valeurs NULL : SQL Server considère que les NULL sont égaux dans les index uniques, donc une seule ligne peut avoir NULL à moins que l'index ne soit filtré.
  • Un chargement dont la source contient des doublons.

Comment le corriger

  1. Trouvez la ligne en conflit avec la valeur du message, puis mettez-la à jour ou ignorez la nouvelle.

    SELECT * FROM dbo.Users WHERE UserName = N'ada';
  2. Pour autoriser de nombreux NULL tout en gardant l'unicité des valeurs non NULL, utilisez un index filtré.

    DROP INDEX UX_Users_TaxId ON dbo.Users;
    CREATE UNIQUE INDEX UX_Users_TaxId ON dbo.Users (TaxId) WHERE TaxId IS NOT NULL;
  3. Vérifiez quelles colonnes l'index couvre.

    EXEC sp_helpindex 'dbo.Users';

Reproduisez-le en toute sécurité

CREATE TABLE #u (v int NULL);
CREATE UNIQUE INDEX ux ON #u (v);
INSERT INTO #u VALUES (NULL);
INSERT INTO #u VALUES (NULL);  -- Msg 2601: The duplicate key value is (<NULL>).
DROP TABLE #u;

Questions

Pourquoi ne puis-je pas insérer un deuxième NULL dans une colonne unique ?

Dans SQL Server, un index ou une contrainte unique considère NULL comme une valeur, donc un seul NULL est autorisé. Un index unique filtré avec WHERE column IS NOT NULL autorise autant de NULL que voulu.

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.