SQLite UPDATE Kullanımı: WHERE ve Çoklu Sütun Güncelleme

UPDATE Mevcut Satırları Değiştirir

INSERT yeni satır ekler. UPDATE ise zaten var olan satırları değiştirir. Yapısı kısa ve ezberlemeye değer:

UPDATE table_name
SET column = value
WHERE condition;

Çalışan bir örnek:

CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT,
    status TEXT DEFAULT 'active'
);

INSERT INTO users (name, email) VALUES
    ('Ada', 'ada@old.com'),
    ('Boris', 'boris@old.com'),
    ('Rosa', 'rosa@old.com');

UPDATE users
SET email = 'ada@new.com'
WHERE id = 1;

SELECT * FROM users;

SET neyi değiştireceğini söyler, WHERE ise hangi satırları. Tablonun geri kalanına dokunulmaz.

Pratikte WHERE Olmadan UPDATE Yazmayın

Teknik olarak WHERE opsiyoneldir. Ama pratikte onu yazmayı unutmak, junior geliştiricilerin tüm öğleden sonrasını mahveden klasik hatadır:

UPDATE users SET status = 'inactive';
-- artık her kullanıcı pasif durumda

Filtre yoksa her satır eşleşir. SQLite de bunu sessiz sedasız yapar. Önce WHERE'i yazıp sonra SET'e geçmeyi alışkanlık edinin — bu küçük refleks bile pek çok kazanın önüne geçiyor.

WHERE koşulunuzdan emin değilseniz, aynı koşulu önce bir SELECT ile çalıştırın:

CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, status TEXT);
INSERT INTO users VALUES (1, 'Ada', 'active'), (2, 'Boris', 'active'), (3, 'Rosa', 'pending');

-- Hangi satırların etkileneceğini önizle.
SELECT id, name, status FROM users WHERE status = 'pending';

-- Ardından tam olarak aynı WHERE ile güncellemeyi çalıştır.
UPDATE users SET status = 'active' WHERE status = 'pending';

SELECT * FROM users;

Aynı koşul, iki ayrı sorgu. SELECT burada deneme çekimi gibi düşün.

Birden Fazla Sütunu Aynı Anda Güncelleme

Tek bir SET içinde, atamaları virgülle ayırarak yazıyoruz. Tek SET, birden çok sütun:

CREATE TABLE products (
    id INTEGER PRIMARY KEY,
    name TEXT,
    price REAL,
    stock INTEGER
);

INSERT INTO products VALUES (1, 'Widget', 9.99, 100);

UPDATE products
SET price = 12.99,
    stock = 75,
    name = 'Premium Widget'
WHERE id = 1;

SELECT * FROM products;

Tek seferde veritabanına gidiş-dönüş, bir satır değişti, üç sütun güncellendi. Tek bir UPDATE ile halledebilecekken üç ayrı UPDATE yazmayın.

= İşaretinin Sağında İfadeler

= işaretinden sonraki değer illa sabit (literal) olmak zorunda değil. Burada herhangi bir ifade kullanabilirsiniz — sütunun mevcut değerine atıfta bulunan bir ifade bile olabilir:

CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, price REAL, stock INTEGER);
INSERT INTO products VALUES
    (1, 'Widget', 10.00, 50),
    (2, 'Gadget', 20.00, 30),
    (3, 'Gizmo', 15.00, 80);

-- Fiyatları %10 artır.
UPDATE products
SET price = price * 1.10;

-- Bir satırın stoğunu azalt.
UPDATE products
SET stock = stock - 1
WHERE id = 2;

SELECT * FROM products;

price * 1.10 ifadesi mevcut fiyatı okur, çarpar ve sonucu geri yazar. SQLite, sağ taraftaki ifadeyi bu cümledeki atamalar uygulanmadan önceki satır değerleriyle değerlendirir; yani aynı anda birden fazla sütuna güvenle başvurabilirsiniz:

UPDATE products SET price = price * 1.10, stock = stock + price;
-- Buradaki sağ taraftaki 'price', az önce güncellenen değer değil ESKİ fiyattır.

UPDATE ... FROM: Başka Bir Tablodan Değer Çekme

SQLite 3.33 ile birlikte UPDATE artık FROM cümlesini destekliyor; yani tablolar arası güncelleme yapabiliyorsunuz. İki tablo arasında veri senkronize etmenin en temiz yolu bu:

CREATE TABLE customers (id INTEGER PRIMARY KEY, name TEXT, total_spent REAL DEFAULT 0);
CREATE TABLE orders (id INTEGER PRIMARY KEY, customer_id INTEGER, amount REAL);

INSERT INTO customers (name) VALUES ('Ada'), ('Boris'), ('Rosa');
INSERT INTO orders (customer_id, amount) VALUES
    (1, 50.00), (1, 30.00),
    (2, 100.00),
    (3, 25.00), (3, 75.00);

UPDATE customers
SET total_spent = totals.sum_amount
FROM (
    SELECT customer_id, SUM(amount) AS sum_amount
    FROM orders
    GROUP BY customer_id
) AS totals
WHERE customers.id = totals.customer_id;

SELECT * FROM customers;

Alt sorgu müşteri bazında toplamları hesaplıyor; dıştaki UPDATE ise bu sonuçları id üzerinden customers tablosuyla birleştiriyor. UPDATE ... FROM olmasaydı her sütun için ayrı bir korelasyonlu alt sorgu yazmak zorunda kalırdınız — çok daha gürültülü olurdu.

Aklınızda bulundurmanız gereken birkaç kural:

• Hedef tablo UPDATE ifadesinden sonra gelir, FROM listesinde yer almaz.
• Birleştirmeyi WHERE ifadesi yapar — burada ON anahtar kelimesi yoktur.
• FROM tarafında birden fazla satırla eşleşme ihtimali varsa sonuç belirsiz olur. Birleştirme anahtarlarınızın hedef satır başına en fazla bir eşleşme üretmesine dikkat edin.

RETURNING: Neyin Değiştiğini Görün

SQLite (3.35 ve sonrası), UPDATE ile değiştirilen satırları aynı ifade içinde döndürmenize olanak tanır. Uygulamanızın güncelleme sonrası değerlere ek bir SELECT çekmeden ulaşması gerektiğinde tam aradığınız şey:

CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, price REAL);
INSERT INTO products VALUES (1, 'Widget', 10.00), (2, 'Gadget', 20.00);

UPDATE products
SET price = price * 0.9
WHERE price > 15
RETURNING id, name, price;

Yapılan değişikliği gerçekten geçirilen satırlarla birlikte, güncellenmiş halleriyle geri alırsınız. Bu sayede ekstra bir sorgu atmaya gerek kalmaz ve eşzamanlı kodda sıkça karşılaşılan bir grup race condition sorunu da ortadan kalkar. RETURNING için bu bölümün ilerleyen sayfalarında ayrı bir başlık var.

UPDATE OR REPLACE: Kısıt Çakışmalarını Yönetmek

Yaptığınız güncelleme bir UNIQUE kısıtını ihlal ediyorsa, varsayılan davranış sorguyu hatayla iptal etmektir. OR ifadesi ise size farklı bir politika seçme imkânı sunar:

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

INSERT INTO users VALUES
    (1, 'ada@x.com', 'Ada'),
    (2, 'boris@x.com', 'Boris');

-- Bu, UNIQUE kısıtlama ihlaliyle başarısız olur:
-- UPDATE users SET email = 'boris@x.com' WHERE id = 1;

-- OR REPLACE çakışan satırı siler, ardından güncellemeyi gerçekleştirir.
UPDATE OR REPLACE users
SET email = 'boris@x.com'
WHERE id = 1;

SELECT * FROM users;

Seçenekler şunlar: OR ABORT (varsayılan), OR REPLACE, OR IGNORE, OR FAIL ve OR ROLLBACK. Bunlar arasında tehlikeli olanı REPLACE — çakışan satırı siler ve bu silme, foreign key zincirleri üzerinden domino etkisi yaratabilir. Yalnızca "bu eşsiz değere sahip bir satır zaten varsa, gözden çıkar" demek istediğinde kullan.

Upsert tarzı işlerin çoğunda, ayrı bir komut olan INSERT ... ON CONFLICT sözdizimi çok daha anlaşılır. Onun için ayrı bir sayfa var.

Riskli Güncellemeleri Transaction İçine Al

Çok sayıda satırı değiştirirken ya da birlikte başarılı olması gereken birden fazla UPDATE çalıştırırken, hepsini bir transaction içine sar. Bir şey ters giderse, her şeyi öncesine geri alabilirsiniz:

CREATE TABLE accounts (id INTEGER PRIMARY KEY, name TEXT, balance REAL);
INSERT INTO accounts VALUES (1, 'Ada', 100.00), (2, 'Boris', 50.00);

BEGIN;
    UPDATE accounts SET balance = balance - 25 WHERE id = 1;
    UPDATE accounts SET balance = balance + 25 WHERE id = 2;
COMMIT;

SELECT * FROM accounts;

İkinci ifade başarısız olursa (mesela bir kısıt devreye girerse), ROLLBACK ilk işlemi de geri alır. Transaction olmadan, yarım kalmış bir transferle baş başa kalırdınız — Ada'nın hesabından 25 düşmüş, Boris'inkine ise hiçbir şey eklenmemiş olurdu. Transaction'ları ileride ayrı bir bölümde detaylıca işleyeceğiz; şimdilik var olduklarını ve toplu güncellemelerin neredeyse her zaman bir transaction içinde yapılması gerektiğini bilin yeter.

Sık Yapılan Hatalar

İnsanların sık tökezlediği birkaç nokta:

• WHERE'i unutmak — bütün satırları günceller. İfadenizi çalıştırmadan önce sesli okuyun.
• WHERE içinde yanlış operatör — WHERE status = NULL hiçbir satırla eşleşmez. Bunun yerine IS NULL kullanın. Operatörler sayfasında bunu detaylıca ele alacağız.
• Tek satır beklerken birden fazla satır döndüren bir alt sorgu (subquery) ile güncelleme yapmak. Ya LIMIT 1 kullanın ya da alt sorguyu aggregate edin; aksi halde hata alır ya da beklemediğiniz sonuçlarla karşılaşırsınız.
• UPDATE OR REPLACE ile UPSERT'ü karıştırmak. OR REPLACE çakışan satırları siler. INSERT ... ON CONFLICT DO UPDATE ise onları yerinde günceller. Bunlar tamamen farklı işlemlerdir.

Sırada: DELETE

UPDATE satırları değiştirir; DELETE ise siler. Aynı WHERE disiplini burada da geçerli — ve "önce bir SELECT çalıştır" alışkanlığı sizi yine aynı tür felaketlerden kurtaracak. Bir sonraki sayfanın konusu bu.