SQLite UNIQUE Kısıtlaması: Tek Sütun, Bileşik Anahtar ve NULL

UNIQUE: "Aynı Değerden İki Tane Olmasın"

SQLite'ta UNIQUE kısıtlaması, bir sütundaki (ya da birden fazla sütunun birlikte oluşturduğu bir grubun) değerlerinin satırlar arasında tekrar etmemesi gerektiğini belirtir. Yani "iki kullanıcı aynı e-postaya sahip olamaz" ya da "bir ürün kodu en fazla bir kez geçer" demenin yolu budur.

CREATE TABLE users (
    id    INTEGER PRIMARY KEY,
    email TEXT UNIQUE,
    name  TEXT
);

INSERT INTO users (email, name) VALUES ('ada@example.com', 'Ada');
INSERT INTO users (email, name) VALUES ('boris@example.com', 'Boris');
INSERT INTO users (email, name) VALUES ('ada@example.com', 'Ada Two');

SELECT * FROM users;

Üçüncü INSERT ifadesi UNIQUE kısıtlaması başarısız oldu: users.email hatasıyla patlar. SQLite, her yazma işleminde kısıtlamayı kontrol eder ve mükerrer kayıt oluşturacak her şeyi reddeder. İlk iki satır kaydedilir; üçüncüsü hiçbir zaman tabloya düşmez.

Perde arkasında UNIQUE, bir unique index olarak tutulur — yani SQLite'ın hızlı arama için kullandığı veri yapısının aynısı. Bu sayede kontrol oldukça ucuza gelir ve sütun otomatik olarak indekslenmiş olur.

Sütun Düzeyi ve Tablo Düzeyi Sözdizimi

UNIQUE kısıtlamasını iki şekilde yazabilirsiniz: ya doğrudan sütunun yanına satır içi olarak, ya da tablo tanımının sonunda ayrı bir ifade olarak:

-- Sütun düzeyinde: basit, tek bir sütun.
CREATE TABLE products (
    sku   TEXT UNIQUE,
    name  TEXT
);

-- Tablo düzeyinde: aynı etki, farklı yerleşim.
CREATE TABLE products2 (
    sku   TEXT,
    name  TEXT,
    UNIQUE(sku)
);

Tek bir sütun için iki yazım da aynı kapıya çıkar — hangisi daha iyi okunuyorsa onu seç. Ama iş birden fazla sütunu birlikte unique yapmaya geldiğinde, tablo seviyesindeki yazım kaçınılmaz hale geliyor.

Composite UNIQUE: SQLite'ta birden fazla sütunu birlikte unique yapmak

Bazen tek bir sütun kendi başına benzersiz olmaz; ama sütunların kombinasyonu benzersiz olmalıdır. Bir kullanıcı birden çok kursa kaydolabilir, bir kurs da birden çok kullanıcıya sahip olabilir — fakat aynı (user_id, course_id) çiftinin tabloda iki kez görünmemesi gerekir:

CREATE TABLE enrollments (
    id        INTEGER PRIMARY KEY,
    user_id   INTEGER NOT NULL,
    course_id INTEGER NOT NULL,
    UNIQUE(user_id, course_id)
);

INSERT INTO enrollments (user_id, course_id) VALUES (1, 100);
INSERT INTO enrollments (user_id, course_id) VALUES (1, 101);  -- sorun yok, farklı kurs
INSERT INTO enrollments (user_id, course_id) VALUES (2, 100);  -- sorun yok, farklı kullanıcı
INSERT INTO enrollments (user_id, course_id) VALUES (1, 100);  -- başarısız: çift zaten mevcut

SELECT * FROM enrollments;

Kısıtlama tek başına sütunlara değil, çiftin kendisine uygulanıyor. 1 numaralı kullanıcı birçok kursa kayıt olabilir, 100 numaralı kurs birçok kullanıcıya sahip olabilir — ama her kombinasyon yalnızca bir kez.

Çoka-çok ilişkilerdeki ara (join) tablolarında bu, klasik ekmek-su deseni.

UNIQUE ile PRIMARY KEY arasındaki fark

Kulağa benzer geliyorlar ve aralarında bir bağ var, ama aynı şey değiller:

• Bir tabloda en fazla bir tane PRIMARY KEY bulunur. UNIQUE kısıtlaması ise birden fazla olabilir.
• PRIMARY KEY, satırın kimliğidir — yabancı anahtarların işaret ettiği, rowid'in takma adı olduğu şeydir.
• UNIQUE ise sadece "bu değer (ya da kombinasyon) tekrar etmesin" demektir.
• Normal bir tabloda UNIQUE bir sütun NULL değer tutabilir; PRIMARY KEY tutamaz (atlayacağımız tarihsel bir istisna dışında).

Sıkça karşılaşılan bir kalıp şöyle:

CREATE TABLE accounts (
    id       INTEGER PRIMARY KEY,   -- dahili kimlik, asla değişmez
    email    TEXT NOT NULL UNIQUE,  -- kullanıcıya yönelik tanımlayıcı, benzersiz olmalı
    username TEXT NOT NULL UNIQUE   -- başka bir benzersiz kullanıcı adı
);

id, veritabanının geri kalanının referans olarak kullandığı alandır. email ve username ise kimlik oldukları için değil, uygulama gereği benzersiz olmak zorunda oldukları için UNIQUE işaretlenir. Kullanıcı e-postasını değiştirdiğinde id aynı kalır — zaten ikisini ayrı tutmanın asıl amacı budur.

NULL Tuhaflığı

Bu konu neredeyse herkesi ilk seferde tuzağa düşürür. SQLite'ta UNIQUE olarak tanımlanmış bir sütun, istediğiniz kadar NULL değer kabul eder:

CREATE TABLE invites (
    id    INTEGER PRIMARY KEY,
    email TEXT UNIQUE
);

INSERT INTO invites (email) VALUES (NULL);
INSERT INTO invites (email) VALUES (NULL);
INSERT INTO invites (email) VALUES (NULL);
INSERT INTO invites (email) VALUES ('ada@example.com');
INSERT INTO invites (email) VALUES ('ada@example.com');  -- bu satır başarısız olur

SELECT * FROM invites;

Üç tane NULL, sorun değil. Ama iki tane 'ada@example.com' olunca çakışma çıkıyor.

Sebebi şu: SQL, NULL değerini "bilinmiyor" olarak görür ve iki "bilinmeyen" birbirine eşit sayılmaz; dolayısıyla teklik kontrolü bunları yinelenmiş kabul edemez. Eğer en fazla bir NULL olmasını istiyorsanız en temiz çözüm NOT NULL UNIQUE kullanmaktır. NULL değerlere izin vermek istiyor ama diğer sütun kombinasyonu başına yalnızca bir tane olsun diyorsanız, partial index devreye girer (ilerideki indeks bölümünde anlatacağız).

Çakışmaları Yönetmek: SQLite ON CONFLICT Kullanımı

Varsayılan olarak bir UNIQUE ihlali çalıştırdığınız ifadeyi iptal eder. Ama bazen başka bir davranış istersiniz: var olan satırı değiştirmek, yenisini görmezden gelmek ya da belirli sütunları güncellemek gibi. SQLite bunu istemenin iki yolunu sunuyor.

İlki, ON CONFLICT ile doğrudan kısıtlamanın içine yazılır:

CREATE TABLE settings (
    key   TEXT UNIQUE ON CONFLICT REPLACE,
    value TEXT
);

INSERT INTO settings (key, value) VALUES ('theme', 'light');
INSERT INTO settings (key, value) VALUES ('theme', 'dark');   -- ilkini değiştirir
INSERT INTO settings (key, value) VALUES ('lang', 'en');

SELECT * FROM settings;

theme ikinci kez eklendiğinde, mevcut satır silinir ve yerini yenisi alır. Diğer seçenekler ise şunlar: IGNORE (sessizce atla), ABORT (varsayılan davranış), FAIL ve ROLLBACK.

İkinci yöntem ise ifade bazlı çalışır ve upsert söz dizimini kullanır. Belirli sütunları güncelleyebildiği için genellikle çok daha esnektir:

CREATE TABLE counters (
    name  TEXT UNIQUE,
    count INTEGER NOT NULL DEFAULT 0
);

INSERT INTO counters (name, count) VALUES ('hits', 1);
INSERT INTO counters (name, count) VALUES ('hits', 1)
    ON CONFLICT(name) DO UPDATE SET count = count + 1;
INSERT INTO counters (name, count) VALUES ('hits', 1)
    ON CONFLICT(name) DO UPDATE SET count = count + 1;

SELECT * FROM counters;

İlk INSERT satırı oluşturur. Sonraki ikisi UNIQUE kısıtlamasına takılır ve DO UPDATE dalına düşerek count değerini bir artırır. Bu, INSERT ... ON CONFLICT upsert kalıbıdır — ileride ona ayrılmış ayrı bir sayfa var.

UNIQUE Kısıtlaması ile UNIQUE Index Arasındaki Fark

CREATE UNIQUE INDEX ifadesi, UNIQUE kısıtlamasıyla aynı işi görür. Hatta UNIQUE kısıtlaması tanımladığınızda SQLite arka planda zaten bir unique index oluşturur — yani aslında aynı mekanizmanın farklı kılıklara bürünmüş halleridir.

CREATE TABLE users (
    id    INTEGER PRIMARY KEY,
    email TEXT NOT NULL
);

CREATE UNIQUE INDEX idx_users_email ON users(email);

INSERT INTO users (email) VALUES ('ada@example.com');
INSERT INTO users (email) VALUES ('ada@example.com');  -- başarısız olur

Hangi durumda hangisini tercih etmeli:

• Tablonun tanımının bir parçası olarak benzersizlik istiyorsanız constraint kullan. Kuralı doğrudan sütunların yanında, belge gibi görürsünüz.
• Kısmi indeks (WHERE koşullu) istiyorsanız, indekse özel bir isim vermek istiyorsanız ya da mevcut bir tabloyu baştan yazmadan kural eklemek istiyorsanız unique index tercih et. SQLite'ta ALTER TABLE ile constraint eklenemez ama indeks her zaman eklenebilir.

Yazma işlemlerindeki davranış ikisinde de aynıdır. Seçim, kuralın şemada nerede dursun istediğinle ilgilidir.

Var Olan Tabloya UNIQUE Eklemek

SQLite'taki ALTER TABLE bilinçli olarak kısıtlı tutulmuştur — ALTER TABLE ... ADD CONSTRAINT diye bir şey yok. Pratikte iki yol var:

-- Seçenek 1: benzersiz indeks ekle. Mevcut tablolarda çalışır, aynı kısıtlamayı uygular.
CREATE TABLE customers (
    id    INTEGER PRIMARY KEY,
    email TEXT
);

INSERT INTO customers (email) VALUES ('ada@example.com');
INSERT INTO customers (email) VALUES ('boris@example.com');

CREATE UNIQUE INDEX idx_customers_email ON customers(email);

INSERT INTO customers (email) VALUES ('ada@example.com');  -- artık başarısız olur

2. Seçenek — UNIQUE kısıtlamasını gerçekten tablo tanımının içine gömmek istiyorsanız — tabloyu yeniden oluşturma dansını yapmanız gerekir: kısıtlamalı yeni bir tablo oluştur, verileri taşı, eskisini sil, yenisini yeniden adlandır. Bunu bir sonraki sayfada ele alıyoruz.

Küçük bir uyarı: Hâlihazırda yinelenen değerler içeren bir sütuna teklik eklemeye çalışırsanız CREATE UNIQUE INDEX komutu hata verir. Önce yinelenen satırları temizleyin, sonra indeksi ekleyin.

UNIQUE hatası: "UNIQUE constraint failed" mesajını okumak

Hata mesajı, hangi kısıtlamanın patladığını size doğrudan söyler:

Hata: UNIQUE kısıtlaması başarısız oldu: users.email
Hata: UNIQUE kısıtlaması başarısız oldu: enrollments.user_id, enrollments.course_id

İlk biçim, users.email üzerinde tek sütunlu bir kısıtlamadır. İkincisi ise bileşik (composite) bir kısıtlamadır — iki sütunun birlikte yazılma sebebi, kombinasyonun zaten var olmasıdır. Bu hatayı gördüğünüzde:

1. Çakışan değerin hangi satırda olduğunu bulun (SELECT ... WHERE email = '...').
2. O satırı güncellemek mi, eklemeyi atlamak mı, yoksa farklı bir değer kullanmak mı istediğinize karar verin.
3. Eğer tekrar eden kayıtlar beklenen bir durumsa ve bunları birleştirmek istiyorsanız, INSERT ... ON CONFLICT DO UPDATE kullanmaya geçin.

Hata bu kadar gürültülü patlıyor çünkü çoğu zaman gerçekten haberdar olmak istersiniz — sessizce eklenen tekrar kayıtlar, başarısız bir yazma işleminden çok daha kötü olurdu.

Sırada: Tabloları Silme ve Değiştirme

UNIQUE kısıtlaması, mevcut bir tabloya basit bir ALTER TABLE ile eklenemez. İşte SQLite'ın şema değişiklikleri için kendine has bir dansı olmasının sebebi de bu — tablonun yeniden yazılması. Bir sonraki sayfanın konusu da tam olarak bu olacak; ayrıca tabloları temiz bir şekilde silmenin temellerine de değineceğiz.