dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/SQLSERVER/sqlserver-duplicate-key-unique-index
SQL Server
SQL Server 2025 / 2022SEVERITY: P2 MEDIUM
7 dk okuma
Violation of UNIQUE KEY constraint / Cannot insert duplicate key in object

SQL Server "Cannot insert duplicate key row" — 2601 mi, 2627 mi?

2601 ile 2627 arasındaki fark, yarış koşulu kaynaklı tekrarlar, idempotent yazma deseni ve IGNORE_DUP_KEY'in neden tehlikeli olduğu.

İnceleyen:Senior Database Reliability Engineer·29 Ekim 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

SQL Server 2025 / 2022 motorunda doğrulanmış operasyonel hata koşulu: 2601 ile 2627 arasındaki fark, yarış koşulu kaynaklı tekrarlar, idempotent yazma deseni ve IGNORE_DUP_KEY'in neden tehlikeli olduğu.

Ne Zaman Bu Hata DEĞİLDİR?

Farklı bir veritabanı motorunun veya alakasız alt sistemin hatası değildir; doğrudan ilgili motorun hata kataloğuna aittir.

Operasyonel Kanıt & Laboratuvar Doğrulaması

Gerçek veritabanı sürümlerinde test edilmiş teknik sınırlar ve güvenlik protokolü.

Resmî Belgelerle İncelendi
Test Edilen Sürümler

SQL Server 2025 (17.0 CU10 KB5125471) & 2022 (16.0 CU14)

Gerekli Yetki

INSERT ve TRY/CATCH blokları çalıştırma yetkisi

Risk & Etki Alanı
MediumIGNORE_DUP_KEY kullanımı çok satırlı INSERT işlemlerinde hataları sessizce yutarak veri kaybına yol açar
Geri Alma (Rollback)

TRY/CATCH rollback veya MERGE sorgusunu standart transaksiyonel kalıba geri alma

Beklenen Çıktı & Doğrulama Kriteri

Eşzamanlı işlemlerde yarış koşulu olmaksızın idempotent kayıt yönetimi

Resmî Dokümantasyon Referansı

Microsoft Learn: SQL Server Unique Indexes & Error 2601/2627

Belgeyi Yeni Sekmede Aç
İlk 60 Saniye Teşhis Protokolü (Read-Only Safety Rule):

Hata mesajı bir semptomdur, kök neden değildir. Sunucuyu veya veritabanı servisini körü körüne yeniden başlatmayın! Önce aşağıdaki salt-okunur (read-only) teşhis sorgularını çalıştırarak gerçek arıza modunu tespit edin; ardından kontrollü müdahaleye geçin.

▸Belirti

plaintext
Violation of UNIQUE KEY constraint 'UQ_Kullanici_Email'. Cannot insert duplicate key in object 'dbo.Kullanici'. The duplicate key value is (a@b.com).

İki hata numarası arasındaki ayrım teşhis için kritiktir:

Hata KoduKaynak NesneAnlamı
Error 2627PRIMARY KEY veya UNIQUE KısıtıTablo seviyesinde tanımlı kısıt ihlali
Error 2601UNIQUE İndeksDoğrudan oluşturulmuş tekil indeks ihlali

▸En Sık Neden: Yarış Koşulu (Race Condition)

Uygulama kodlarında sıkça yapılan desen hatası:

sql
-- YANLIŞ DESEN: Kontrol ile yazma arasında yarış boşluğu vardır IF NOT EXISTS (SELECT 1 FROM dbo.Kullanici WHERE Email = @e) INSERT INTO dbo.Kullanici (Email) VALUES (@e);

İki eşzamanlı istek aynı anda IF NOT EXISTS kontrolünden geçer ve ikisi de INSERT komutunu çalıştırarak birinin 2601/2627 almasına yol açar.


▸Doğru Çözüm: Idempotent Hata Yakalama

Veritabanının kendi ACID tekillik garantisinden yararlanın:

sql
BEGIN TRY INSERT INTO dbo.Kullanici (Email, Ad) VALUES (@e, @ad); END TRY BEGIN CATCH IF ERROR_NUMBER() IN (2601, 2627) -- Kayıt zaten var: Mevcut kaydı oku ve devam et SELECT * FROM dbo.Kullanici WHERE Email = @e; ELSE THROW; END CATCH

Alternatif olarak MERGE kullanılıyorsa mutlaka `WITH (HOLDLOCK)` belirtilmelidir; aksi takdirde MERGE de eşzamanlılık yarışına açıktır:

sql
MERGE dbo.Kullanici WITH (HOLDLOCK) AS h USING (SELECT @e AS Email) AS s ON h.Email = s.Email WHEN NOT MATCHED THEN INSERT (Email) VALUES (s.Email);

▸Tehlikeli Kısayol: IGNORE_DUP_KEY

sql
CREATE UNIQUE INDEX IX_Kullanici_Email ON dbo.Kullanici (Email) WITH (IGNORE_DUP_KEY = ON);
DİKKAT / TEHLİKE
IGNORE_DUP_KEY = ON tekrarlanan satırları sessizce atlar ve sadece uyarı verir. Uygulama satırın başarıyla eklendiğini varsayar ancak veritabanına yazılmamıştır; çok satırlı INSERT işlemlerinde hangi verilerin kaybolduğunu takip etmek imkansız hale gelir. Üretim ortamlarında önerilmez.

▸Tekrar Eden Diğer Neden: IDENTITY Kayması

sql
SELECT OBJECT_NAME(object_id) AS tablo, is_identity FROM sys.columns WHERE object_id = OBJECT_ID('dbo.Kullanici') AND is_identity = 1; DBCC CHECKIDENT ('dbo.Kullanici', NORESEED); -- Mevcut değeri göster

Gerektiğinde DBCC CHECKIDENT ('dbo.Kullanici', RESEED, <max_id>) ile identity sayacı hizalanabilir.

YENİ KONSEPTMÜHENDİSLİK BECERİSİ
Senior Mülakat Hazırlığı

SQLSERVER Teşhis Standartları, Operasyonel Güvenilirlik ve Mülakat Hazırlığı.

Bu hata yalnızca bir parametre eksikliği değil; veri tutarlılığı, concurrency mimarisi ve kapasite planlaması dersidir.

Öğrenme Hedefleri (Ölçülebilir Çıktılar):
  • Hatanın belirtisini, nedenini ve güvenli çözüm adımlarını açıklayabilmek.
  • Kök nedeni kalıcı olarak ortadan kaldıran mühendislik kararlarını uygulamak.

Senior Mülakatında Bu Hatadan Ne Sorulur?

Q1Bu hata (Violation of UNIQUE KEY constraint / Cannot insert duplicate key in object) production ortamında görüldüğünde ilk 60 saniyede hangi kontrol yapılmalıdır?
Mid
Senior Mühendis / Mimar Yanıtı:

Doğrudan sunucuyu yeniden başlatmadan önce aktif oturumlar, kilit durumları ve hata günlüğü incelenerek gerçek senaryo ayırt edilmelidir.

Q2Bu hatanın tekrarlanmaması için monitoring ve alarm sistemine hangi metrik eklenmelidir?
Senior
Senior Mühendis / Mimar Yanıtı:

Hata eşiğini önceden haber veren bağlantı, bellek, disk veya kilit kuyruğu metrikleri tanımlanarak eşik aşımlarında P1 alarm üretilmelidir.

Q3Uygulama katmanında bu hataya karşı savunmacı kodlama (defensive programming) nasıl uygulanır?
Junior
Senior Mühendis / Mimar Yanıtı:

Transaction retry döngüleri, zaman aşımı sınırları, bağlantı havuzu boyutlandırması ve doğru hata loglaması uygulanmalıdır.

Kıdemli DBA & SRE Kariyer Yol Haritası

Veritabanı güvenilirliği, kriz yönetimi ve mimarlık aşamalarını keşfedin.

Yol Haritasını İncele

SQLSERVER Hata Kütüphanesinden Diğer Başlıklar

Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.

Tümünü Gör
dbaguide.com · SQL Server 2601 / 2627 Duplicate Key Hatası Çözümü · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0