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.
Teshis & Ayırt Etme Protokolü (Disambiguation)
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.
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ü.
PostgreSQL 14.10, 15.6, 16.4, 17.0 (Ubuntu 24.04 LTS, Docker 26.1, Kernel 6.8)
SUPERUSER veya pg_read_all_stats / pg_signal_backend
Geçici session timeout parametrelerini sıfırlama, pgbouncer reload veya pool boyutunu eski haline alma
pg_stat_activity sorgusunda bağlantı sayısının güvenli eşik altına inmesi
PostgreSQL Docs: Connections
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
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
iddeğ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
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:
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:
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
- •PostgreSQL İlk Restore Tatbikatı Runbook'u
- •PostgreSQL Backup & Restore CheatSheet
- •Test edilen sürümler: PostgreSQL 14 / 15 / 16 / 17
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.
- 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
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
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
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.
POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar
Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.
PostgreSQL Bağlantı Tükenmesi ve too many clients Teşhisi
FATAL: sorry, too many clients already ve remaining connection slots hatalarının üç temel kök nedeni, yetki sınırlarıyla salt okunur pg_stat_activity teşhisi ve kalıcı iki katmanlı havuzlama çözümü.
PostgreSQL password authentication failed Hatası: Neden ve Çözüm
psql password authentication failed hatasının dört nedeni: yanlış şifre, md5/SCRAM uyuşmazlığı, pg_hba.conf sırası ve yanlış cluster. Adım adım teşhis.
PostgreSQL connection refused: 8 Adımda Kesin Teşhis
Connection refused, timeout ve "no pg_hba.conf entry" arasındaki fark; listen_addresses, port, firewall ve Docker port yayınlama kontrolleri.