2627: Violation of PRIMARY KEY / UNIQUE KEY constraint. Cannot insert duplicate key in object (violation de contrainte PRIMARY KEY / UNIQUE KEY ; clé en double non insérable)

Que signifie cette erreur ?

Vous avez tenté d'insérer ou de mettre à jour une valeur qui existe déjà dans une ou plusieurs colonnes protégées par une contrainte PRIMARY KEY ou UNIQUE. Les clés en double ne sont pas acceptées.

Cause

Insertion de la même valeur unique une seconde fois, UPDATE entrant en collision avec une valeur existante, absence de contrôle d'unicité, ou deux requêtes concurrentes produisant la même ligne.

Comment la corriger

Vérifiez si la ligne existe avant l'insertion, ou utilisez MERGE / IF NOT EXISTS. Pour des insertions idempotentes, appliquez le modèle "INSERT ... WHERE NOT EXISTS". Interceptez l'erreur et renvoyez un message explicite. Si vous avez réellement besoin de données en double, revoyez la contrainte. Utilisez IDENTITY ou SEQUENCE pour éviter les collisions lors de la génération des clés.