PostgreSQL “violates not-null constraint” hatası, NOT NULL olarak tanımlanan bir sütuna NULL değer gönderildiğinde oluşur. Çözüm için hatada belirtilen sütunu INSERT içinde doldurabilir, uygun bir DEFAULT değeri tanımlayabilir veya kısıtın gerçekten gerekli olup olmadığını veri yapısıyla birlikte değerlendirebilirsin.
NOT NULL kısıtı bu hatayı neden üretir?
PostgreSQL bu hatayı, NOT NULL ile işaretlenmiş bir sütuna NULL yazılmaya çalışıldığında üretir. Kısıt, tablodaki verilerin uyması gereken bir kuraldır. NOT NULL kuralı da ilgili sütunda değer yokluğuna izin vermez.
Örneğin null value in column "ad" of relation "ogrenciler" violates not-null constraint mesajını şu şekilde okuyabilirsin:
null value, yazılmaya çalışılan değerinNULLolduğunu belirtir.column "ad", sorunlu sütununadolduğunu gösterir.relation "ogrenciler", işleminogrencilertablosunda gerçekleştiğini belirtir.violates not-null constraint, sütununNOT NULLkuralının ihlal edildiğini açıklar.
NULL, bir değerin bulunmadığını veya bilinmediğini ifade eder. Boş metin olan '' ise uzunluğu sıfır olan ayrı bir metin değeridir. Bu nedenle ad sütununa '' gönderilmesi, veri anlamlı olmasa bile teknik olarak NULL göndermekle aynı değildir. Hata mesajının tam biçimi PostgreSQL sürümüne ve istemcinin mesajı gösterme şekline göre küçük farklılıklar gösterebilir.
Teşhis sırasında şu sırayı izleyebilirsin:
- Mesajdaki
columnbölümünü bul ve sorunlu sütun adını belirle. relationbölümünden işlemin yapıldığı tabloyu kontrol et.INSERTveyaUPDATEiçinde bu sütuna hangi ifadenin gönderildiğini incele.- Sütunun
NOT NULLtanımını ve varsaDEFAULTdeğerini kontrol et.
INSERT sırasında zorunlu alan nasıl tamamlanır?

Zorunlu ad alanı INSERT içinde verilmediğinde PostgreSQL satırı ekleyemez ve violates not-null constraint hatasını üretir. Aşağıdaki tablo örneğinde ad zorunludur, eposta isteğe bağlıdır ve kayit_tarihi için varsayılan değer kullanılır.
CREATE TABLE ogrenciler (
id integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
ad text NOT NULL,
eposta text,
kayit_tarihi date DEFAULT CURRENT_DATE
);
Bu komut ogrenciler tablosunu oluşturur. ad sütunu boş bırakılamaz; eposta gönderilmezse NULL olabilir. kayit_tarihi belirtilmezse PostgreSQL tanımlanan varsayılan değeri kullanır.
INSERT INTO ogrenciler (eposta, kayit_tarihi)
VALUES ('[email protected]', CURRENT_DATE);
Bu INSERT ifadesinde ad sütunu listede bulunmadığı için PostgreSQL bu sütun için değer bulamaz. ad sütununda bir DEFAULT tanımlı olmadığından değer NULL kabul edilir ve işlem NOT NULL kısıtında durur.
INSERT INTO ogrenciler (ad, eposta)
VALUES ('Ayşe Yılmaz', '[email protected]')
RETURNING id, ad, eposta, kayit_tarihi;
Bu sürümde zorunlu ad değeri açıkça verilir. id otomatik üretilir, kayit_tarihi ise kendi DEFAULT değerini kullanır. RETURNING ifadesi eklenen satırın oluşan değerlerini gösterir.
Sütun listesini her zaman açıkça yazmak, değerlerin tablo tanımındaki sıraya yanlışlıkla bağlanmasını önler. Bir INSERT çalıştırmadan önce sütun listesini kontrol et, verilen değer sayısını bu listeyle eşleştir ve NOT NULL olan alanların değer, DEFAULT veya otomatik üretim mekanizmasıyla karşılandığından emin ol.
Otomatik artan id için NULL neden sorun çıkarır?
Otomatik artan bir id sütununa açıkça NULL gönderirsen PostgreSQL bunu sütun atlanmış gibi değerlendirmez. Bu durumda varsayılan değer üretim mekanizması kullanılmayabilir ve NOT NULL ihlali oluşabilir. IDENTITY sütunları otomatik olarak NOT NULL kabul edilir; SERIAL ise sıra üreten bir varsayılan ifadeyle birlikte tamsayı sütunu oluşturur.
Yeni kimlik değerinin otomatik üretilmesini istiyorsan en güvenli yaklaşım, id sütununu INSERT listesinden çıkarmaktır:
INSERT INTO ogrenciler (ad, bolum)
VALUES ('Ece', 'Bilgisayar Programcılığı');
Bu sorguda PostgreSQL, id sütunu için tanımlı identity veya sequence tabanlı varsayılan değeri kullanır ve yeni satıra bir kimlik değeri atar. Açıkça NULL göndermekten farklı olarak burada sütun hiç belirtilmemiştir.
Sütunu liste içinde tutman gereken durumlarda değeri DEFAULT olarak belirtebilirsin:
INSERT INTO ogrenciler (id, ad, bolum)
VALUES (DEFAULT, 'Mert', 'Bilgisayar Programcılığı');
Bu örnekte de id için yeni sıra değeri üretilir. NULL ise “değeri otomatik üret” anlamına gelmez; açık bir boş değer gönderdiği için NOT NULL kısıtını ihlal edebilir.
DEFAULT değeri sorunu tasarım düzeyinde nasıl çözer?

Bir alan için geçerli ve anlamlı bir varsayılan değer tanımlamak, her INSERT işleminde aynı değeri tekrar tekrar yazma ihtiyacını azaltır. Örneğin kayıt tarihi çoğu satır için ekleme günü olacaksa bunu tabloya tanımlayabilirsin.
ALTER TABLE ogrenciler
ALTER COLUMN kayit_tarihi SET DEFAULT CURRENT_DATE;
INSERT INTO ogrenciler (ad, bolum)
VALUES ('Selin', 'Bilgisayar Programcılığı');
İkinci sorguda kayit_tarihi belirtilmediği için sütun, CURRENT_DATE ifadesinin ürettiği tarihle doldurulur. Aynı davranışı sütunu listeye ekleyip DEFAULT yazarak da isteyebilirsin.
DEFAULT yalnızca sütun atlandığında veya açıkça DEFAULT kullanıldığında uygulanır. kayit_tarihi için NULL gönderirsen PostgreSQL bu değeri otomatik olarak CURRENT_DATE ile değiştirmez. Bu nedenle varsayılan değer belirlerken şu soruları birlikte değerlendirmek gerekir:
- Bu değer kayıtların çoğu için geçerli ve anlamlı mı?
- Açıkça
NULLbırakmak iş kuralı açısından gerekli mi? - Değeri uygulama mı üretmeli, yoksa veritabanı mı üretmeli?
Varsayılan değer, iş kuralını doğru yansıtıyorsa veri girişini sadeleştirir. Her sütuna rastgele bir değer atamak ise eksik veya yanlış veriyi görünmez hâle getirebilir.
Mevcut tabloya NOT NULL sütun nasıl eklenir?
Mevcut satırlar yeni sütun için geçerli bir değer almadan NOT NULL kuralı uygulanamaz. Kısıt, bir sütunun hangi değerleri kabul edebileceğini belirleyen veritabanı kuralıdır. Yeni sütun eklendiğinde eski satırlar için değer üretilemiyorsa PostgreSQL bu kuralı doğrulayamaz.
Tüm eski kayıtlar için aynı varsayılan değer anlamlıysa sütunu tek komutla ekleyebilirsin:
ALTER TABLE ogrenciler
ADD COLUMN kayit_tarihi date
DEFAULT CURRENT_DATE
NOT NULL;
Bu komut, kayit_tarihi sütununu oluşturur ve mevcut satırlar için komutun çalıştırıldığı tarihteki değeri kullanır. Yeni kayıtlarda sütun belirtilmezse DEFAULT CURRENT_DATE devreye girer. Bu yöntem, kayıt tarihi için aynı başlangıç tarihinin kullanılmasının veri açısından doğru olduğu durumlarda uygundur.
Her öğrencinin tarihi mevcut verilerden türetilmeliyse önce sütunu boş değerlere izin verecek şekilde eklemek, ardından doldurmak daha güvenlidir. Aşağıdaki örnekte ogrenciler tablosunda anlamlı tarih taşıyan olusturma_tarihi sütununun bulunduğu varsayılır:
ALTER TABLE ogrenciler
ADD COLUMN kayit_tarihi date;
UPDATE ogrenciler
SET kayit_tarihi = olusturma_tarihi
WHERE kayit_tarihi IS NULL;
ALTER TABLE ogrenciler
ALTER COLUMN kayit_tarihi SET DEFAULT CURRENT_DATE;
ALTER TABLE ogrenciler
ALTER COLUMN kayit_tarihi SET NOT NULL;
İlk komut yeni sütunu ekler, UPDATE mevcut satırların değerlerini gerçek veriden üretir. Son iki komut ise değeri belirtilmeyen yeni kayıtlar için varsayılanı tanımlar ve sütunun bundan sonra boş bırakılamamasını sağlar. SET NOT NULL çalışırken tabloda hâlâ NULL bulunan bir satır varsa işlem başarısız olur.
- Geçerli varsayılan varsa: Tüm eski satırlar için aynı değer anlamlıysa tek komutlu çözüm kullanılabilir.
- Mevcut veriden hesaplanacaksa: Sütun önce eklenir, satırlar
UPDATEile doldurulur ve ardındanNOT NULLuygulanır. - Eksik veri iş kararı gerektiriyorsa: Rastgele bir tarih ya da metin vermek yerine kayıtların nasıl sınıflandırılacağı belirlenmelidir.
Bu üçlü ayrım, teknik işlemi veri anlamından ayırmamayı sağlar. Bir değer yalnızca hata almamak için ekleniyorsa, ileride raporları ve uygulama davranışını yanıltabilir.
Kısıtı kaldırmadan önce hangi kontroller yapılır?
NOT NULL kısıtını kaldırmak hata mesajını susturabilir; ancak veri bütünlüğü sorunu uygulamanın sonraki katmanlarına taşınabilir. Bu nedenle önce hatanın kaynağını incelemek gerekir.
Önce hata mesajındaki tablo ve sütun adını belirle. Ardından ilgili INSERT veya UPDATE komutunda açıkça NULL gönderilip gönderilmediğini kontrol et. Sütun komutta hiç yer almıyorsa varsayılan değer tanımını, yeni eklenen bir sütunsa mevcut satırların değer taşıyıp taşımadığını incele.
Sık yapılan üç hata şunlardır:
NOT NULLkuralını kaldırarak asıl veri akışı sorununu gizlemek.- Boş metin ile
NULLdeğerini aynı kabul etmek. Boş metin uzunluğu sıfır olan bir metindir,NULLise değer bulunmadığını ifade eder. INSERTsırasında sütun listesi yazmadan değerlerin tablo sırasına güvenmek. Sütun sırası değiştiğinde veya yeni bir zorunlu sütun eklendiğinde bu yaklaşım hatalara yol açabilir.
Sütunların boş değere izin verip vermediğini ve varsayılan tanımlarını görmek için şema adını belirterek şu sorguyu kullanabilirsin:
SELECT column_name, is_nullable, column_default
FROM information_schema.columns
WHERE table_schema = 'public'
AND table_name = 'ogrenciler'
ORDER BY ordinal_position;
Sorgudaki public yerine tablonun bulunduğu şemayı, ogrenciler yerine gerçek tablo adını yazmalısın. is_nullable sütunun boş değere izin verip vermediğini, column_default ise yeni değer belirtilmediğinde kullanılacak varsayılan ifadeyi gösterir.
NOT NULL kısıtını kaldırma kararı ancak alanın veri modelinde gerçekten isteğe bağlı olduğu belirlendiğinde değerlendirilmelidir. Sorun yalnızca bir INSERT hatasıysa önce veri akışını, varsayılanı ve sütun listesini düzeltmek daha sağlıklı bir yaklaşımdır.
Sık Sorulan Sorular
PostgreSQL’de NULL ile boş metin arasındaki fark nedir?
PostgreSQL’de NULL bir değerin bulunmadığını veya bilinmediğini ifade eder, boş metin ise uzunluğu sıfır olan gerçek bir metindir. Bu nedenle NULL kontrolü için IS NULL kullanılır; = '' ifadesi boş metni arar.
INSERT komutunda sütun listesini yazmak neden önemlidir?
INSERT komutunda sütun listesini yazmak, her değerin hangi sütuna gideceğini açıkça belirler ve tablo sütun sırasına bağımlılığı azaltır. Ayrıca otomatik varsayılanı olan sütunları komuttan çıkararak PostgreSQL’in bu varsayılanları kullanmasına izin verir.
Otomatik artan id sütununa NULL yerine ne gönderilmelidir?
Otomatik artan id sütunu için genellikle hiçbir değer gönderilmemeli ve sütun INSERT listesinden çıkarılmalıdır. Identity ya da sequence tabanlı varsayılan tanım, yeni kayıt için değeri kendisi üretir.
DEFAULT tanımlı bir sütuna açıkça NULL gönderilirse ne olur?
Bir sütuna açıkça NULL gönderildiğinde DEFAULT değeri kullanılmaz. Sütun NOT NULL ise işlem hata verir; varsayılan değer yalnızca sütun için değer belirtilmediğinde devreye girer.
Mevcut bir tabloya NOT NULL sütun eklenirken eski satırlar nasıl doldurulur?
Eski satırlar, geçerli bir DEFAULT ile doldurulabilir veya sütun önce nullable eklenip UPDATE ile mevcut verilerden üretilen değerlerle tamamlanabilir. Tüm satırlar dolduktan sonra SET NOT NULL uygulanır.
Bu adımları izlediğinde hata mesajını yalnızca susturmak yerine, eksik değerin kaynağını ve sütunun veri modelindeki rolünü birlikte değerlendirmiş olursun.