Geliştirme

PostgreSQL Constraints: CHECK, UNIQUE ve Foreign Key Rehberi

Mehmet Fatih Ünal
7 Kasım 2026
7 dk okuma
#PostgreSQL#SQL#Constraints#Foreign Key#Veri Bütünlüğü
PostgreSQL Constraints: CHECK, UNIQUE ve Foreign Key Rehberi

PostgreSQL constraints neden uygulama doğrulamasını tamamlar?

PostgreSQL constraints, veritabanına yazılabilecek verinin kurallarını tanımlar. Bir ürünün fiyatının negatif olmaması, kodunun tekrarlanmaması ve grubunun mevcut olması farklı kurallardır. PostgreSQL kısıtlar belgesi, CHECK, NOT NULL, UNIQUE ve foreign key seçeneklerini açıklar.

Formda kontrol yapmak kullanıcıya hızlı geri bildirim sağlar. Ancak veri yalnızca o formdan gelmeyebilir: başka bir servis, içe aktarma veya yönetim komutu da aynı tabloya yazabilir. Uygulama doğrulamasıyla veritabanı kuralını birbirinin yerine koymak, bu yazma yollarından birini açık bırakabilir.

Aşağıdaki öğretici modelde fiyat kuruş cinsinden tam sayıdır. Vergi, para birimi ve indirim gibi ayrı konuları kapsamaz. Örnekleri aynı PostgreSQL oturumunda çalıştırın; tablolar geçicidir:

CREATE TEMP TABLE catalog_groups (id integer PRIMARY KEY);
CREATE TEMP TABLE catalog_products (
  id integer PRIMARY KEY,
  sku text NOT NULL,
  price_cents integer NOT NULL,
  group_id integer NOT NULL REFERENCES catalog_groups(id) ON DELETE RESTRICT,
  CONSTRAINT catalog_products_sku_unique UNIQUE (sku),
  CONSTRAINT catalog_products_price_check CHECK (price_cents >= 0)
);
INSERT INTO catalog_groups VALUES (1);
INSERT INTO catalog_products VALUES (1, 'BOOK', 1500, 1);

CHECK hangi fiyatları kabul eder?

Modelin fiyat kuralı sıfır ve üzeridir; dolayısıyla ücretsiz bir ürün geçerlidir. CHECK ifadesini iş kuralına göre yazın. Sıfırın yasak olduğu bir ürün için >= yerine > gerekir.

INSERT INTO catalog_products VALUES (2, 'PEN', 0, 1);
SELECT id, sku, price_cents FROM catalog_products ORDER BY id;

Sonuçta BOOK için 1500, PEN için 0 görülür. Alanın integer olması tek başına negatif fiyatı engellemez; veri türüyle aralık kuralı farklı sorumluluklardır. Ondalık fiyat kullanıyorsanız da aynı mantıkla kesin hassasiyet ve aralık kararını ayrı verin.

Hatalı yazma işlemleri nasıl denenir?

Aşağıdaki üç komutun her biri ayrı ayrı hata üretmek için yazılmıştır. Hepsini başarılı bir içe aktarma betiği gibi düşünmeyin; istemciniz ilk hatada durabilir:

-- CHECK ihlali: negatif fiyat.
INSERT INTO catalog_products VALUES (3, 'NEGATIVE', -1, 1);

-- UNIQUE ihlali: BOOK zaten var.
INSERT INTO catalog_products VALUES (3, 'BOOK', 2000, 1);

-- Foreign key ihlali: grup 99 mevcut değil.
INSERT INTO catalog_products VALUES (3, 'UNKNOWN-GROUP', 100, 99);

Beklenen hata türünü kontrol etmek, yalnızca “bir hata geldi” demekten daha güçlüdür. Aynı komutun yazım yanlışı veya bağlantı sorunu yüzünden başarısız olması, kuralın çalıştığını kanıtlamaz. Kısıt adlarını anlamlı seçmek de hangi kuralın ihlal edildiğini uygulamada eşlemeyi kolaylaştırır.

Bir transaction içindeki komut başarısız olduğunda sonraki denemeler için rollback veya uygun savepoint yönetimi gerekebilir. Transaction rehberi işlem sınırlarını, Problem Details rehberi istemciye tutarlı hata sunmayı ele alır. Ham veritabanı hata metnini kullanıcıya taşımak yerine uygun ürün mesajını seçin.

CHECK varken NOT NULL neden ayrı yazılır?

CHECK ifadesinin sonucu NULL olduğunda da kısıt geçilmiş sayılabilir. Bu nedenle aşağıdaki farklı tabloda eksik tutar kabul edilir:

CREATE TEMP TABLE optional_amounts (amount integer CHECK (amount >= 0));
INSERT INTO optional_amounts VALUES (NULL);
SELECT amount IS NULL AS stored_missing FROM optional_amounts;

Çıktı true olur. Asıl ürün tablosunda price_cents için NOT NULL bulunmasının sebebi budur. Varsayılan değer tanımlamak da açıkça gönderilmiş NULL değerini otomatik olarak o varsayılana dönüştürmez. NULL rehberindeki bilinmeyen değer ayrımını model kararına dahil edin.

UNIQUE ve foreign key hangi kararları size bırakır?

Varsayılan UNIQUE davranışında NULL değerler birbirine eşit sayılmaz. Zorunlu bir ürün kodunda UNIQUE ile NOT NULL birlikte kullanılabilir. İsteğe bağlı kodlarda bunun etkisini küçük bir örnekle görün:

CREATE TEMP TABLE optional_codes (code text UNIQUE);
INSERT INTO optional_codes VALUES (NULL), (NULL);
SELECT count(*) FROM optional_codes;

Sonuç 2'dir. Büyük/küçük harf veya baştaki boşluk bakımından iki kodun aynı sayılıp sayılmayacağını bu örnek belirlemez. Giriş normalizasyonu ve benzersizlik kuralı aynı kimlik tanımını kullanmalıdır.

Ürün tablosundaki ON DELETE RESTRICT ise kullanılan bir grubun silinmesini engeller. Başka bir modelde CASCADE veya SET NULL seçmek farklı bir yaşam döngüsü kararıdır; otomatik silmeyi yalnızca hata susturmak için açmayın. Foreign key, bir ilişkinin mevcut olduğunu doğrular; kullanıcının o kayda erişim yetkisini doğrulamaz.

Sık sorulan sorular

Form doğrulaması varsa kısıt gereksiz mi? Hayır. Farklı yazma yollarını ve kalıcı veri kurallarını ayrıca korur.

CHECK eksik fiyatı engeller mi? Tek başına bu örnekte engellemez. Eksik değer yasaksa NOT NULL kullanın.

Kısıt eklemek mevcut hatalı veriyi düzeltir mi? Hayır. Geçişten önce mevcut veriyi inceleyin; kuralı ekleme ve temizleme adımlarını planlayın.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar