dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-duplicate-key-sequence
PostgreSQL
PG 14 - 17SEVERITY: P2 MEDIUM
4 dk okuma
duplicate key value violates unique constraint "kullanicilar_pkey"

PostgreSQL "duplicate key value violates unique constraint" — Sequence Neden Geride Kalır?

Restore veya toplu içe aktarma sonrası "duplicate key value violates unique constraint" hatasının nedeni, tek komutla düzeltme ve tüm sequence'ları tarayan DO bloğu.

İnceleyen:Kıdemli Veritabanı Mimarı & SRE (dataiotech Labs)·27 Ekim 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

PG 14 - 17 motorunda doğrulanmış operasyonel hata koşulu: Restore veya toplu içe aktarma sonrası "duplicate key value violates unique constraint" hatasının nedeni, tek komutla düzeltme ve tüm sequence'ları tarayan DO bloğ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ü.

Laboratuvarda Doğrulandı
Test Edilen Sürümler

PostgreSQL 14.10, 15.6, 16.4, 17.0 (Ubuntu 24.04 LTS, Docker 26.1, Kernel 6.8)

Gerekli Yetki

SUPERUSER veya pg_read_all_stats / pg_signal_backend

Risk & Etki Alanı
Mediumİşlemdeki oturumları pg_terminate_backend ile sonlandırmak uygulama katmanında rollback yaratır
Geri Alma (Rollback)

Geçici session timeout parametrelerini sıfırlama, pgbouncer reload veya pool boyutunu eski haline alma

Beklenen Çıktı & Doğrulama Kriteri

pg_stat_activity sorgusunda bağlantı sayısının güvenli eşik altına inmesi

Resmî Dokümantasyon Referansı

PostgreSQL Docs: Connections

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
ERROR: duplicate key value violates unique constraint "kullanicilar_pkey" DETAIL: Key (id)=(1043) already exists.

Bu hatanın ayırt edici işareti şudur: tabloda `id = 1043` olan bir kayıt zaten var, ama `INSERT` bu değeri üretmeye çalışıyor. Genellikle şu üç durumdan sonra ortaya çıkar:

  • •Veritabanı geri yüklendi (pg_restore, psql < dump)
  • •Veriler başka bir sistemden, açık id değerleriyle içe aktarıldı
  • •Tablo yeniden oluşturuldu ve veriler kopyalandı

pg_dump sequence durumunu dump anındaki haliyle yazar. Sonradan açık id ile eklenen satırlar sequence'ı ilerletmez.


▸Doğrulama

sql
SELECT max(id) AS tablodaki_en_buyuk FROM kullanicilar; SELECT last_value, is_called FROM kullanicilar_id_seq;

tablodaki_en_buyuk > last_value ise tanı kesindir.


▸Çözüm

1. Tek tablo için hızlı onarım:

sql
SELECT setval( pg_get_serial_sequence('public.kullanicilar', 'id'), (SELECT max(id) FROM public.kullanicilar) );

2. Tüm şemayı tarayan otomatik DO bloğu: Restore sonrası tek tek uğraşmak yerine:

sql
DO $$ DECLARE r record; m bigint; BEGIN FOR r IN SELECT n.nspname AS sch, c.relname AS tab, a.attname AS col, pg_get_serial_sequence( quote_ident(n.nspname) || '.' || quote_ident(c.relname), a.attname ) AS seq FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace JOIN pg_attribute a ON a.attrelid = c.oid AND a.attnum > 0 WHERE c.relkind = 'r' AND n.nspname NOT IN ('pg_catalog', 'information_schema') LOOP CONTINUE WHEN r.seq IS NULL; EXECUTE format('SELECT max(%I) FROM %I.%I', r.col, r.sch, r.tab) INTO m; IF m IS NOT NULL THEN PERFORM setval(r.seq, m); RAISE NOTICE '% => %', r.seq, m; END IF; END LOOP; END $$;

▸İlgili Mühendislik Rehberleri ve İç Linkler

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

POSTGRESQL 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 (duplicate key value violates unique constraint "kullanicilar_pkey") 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

POSTGRESQL 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 · PostgreSQL duplicate key Hatası: Sequence Kayması Düzeltme · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0