UPSERT (INSERT ON CONFLICT) nedir?

Question

Accepted Answer

**UPSERT** "ekle, ya da zaten varsa güncelle" anlamına gelir. PostgreSQL bunu **`INSERT ... ON CONFLICT`** ile uygular — bir satır ekle, ancak bu benzersiz bir kısıtlamayı ihlal ederse, bunun yerine mevcut satırı güncelle (ya da hiçbir şey yapma). Ortak "ekle-veya-güncelle" ihtiyacını atomik şekilde işler.

## UPSERT'ün çözdüğü sorun

```text
You want to insert a row, but it might already exist (by a unique key):
  ❌ a plain INSERT fails with a unique-violation error if it exists
  ❌ check-then-insert (SELECT, then INSERT or UPDATE) has a RACE CONDITION
     (another transaction could insert between your check and insert)
→ ON CONFLICT does it atomically in ONE statement (no race condition)
```

## ON CONFLICT DO UPDATE — ekle veya güncelle

```sql
INSERT INTO users (email, name, login_count)
VALUES ('ann@x.com', 'Ann', 1)
ON CONFLICT (email)                  -- if a row with this email already exists...
DO UPDATE SET                        -- ...UPDATE it instead
  name = EXCLUDED.name,              -- EXCLUDED = the values you tried to insert
  login_count = users.login_count + 1;  -- can reference the existing row too
```

Eklemek `email` benzersiz kısıtlaması ile çakışırsa, Postgres mevcut satırı günceller. **`EXCLUDED`** eklemek için denediğin değerleri ifade eder ve mevcut satıra da başvurabilirsin (`users.login_count`) — sayaç artırma gibi mantığı sağlar.

## ON CONFLICT DO NOTHING — ekle veya atla

```sql
INSERT INTO users (email, name) VALUES ('ann@x.com', 'Ann')
ON CONFLICT (email) DO NOTHING;      -- if it exists, just skip (no error)
```

`DO NOTHING` çakışan satırları sessizce atlar — "yoksa ekle" durumunda hata olmaksızın yararlıdır.

## Sık kullanılan gerçek durum: sayaçlar ve etkisiz eklemeler

```sql
-- track page views — insert on first view, increment on subsequent
INSERT INTO page_views (page_id, views) VALUES (5, 1)
ON CONFLICT (page_id) DO UPDATE SET views = page_views.views + 1;
```

## Neden önemli

UPSERT (`INSERT ... ON CONFLICT`), çok ortak "ekle-veya-güncelle" ihtiyacını temiz ve **güvenli** şekilde çözen önemli, pratik bir PostgreSQL özelliğidir, bu nedenle onu anlamak gerçek dünya veri işlemleri için yararlıdır.

İhtiyaç — benzersiz bir anahtar tarafından zaten var olabilecek bir satırı eklemek (UPSERT kayıtlar, sayaçlar, etkisiz eklemeler, veri senkronizasyonu) — sürekli ortaya çıkar ve naif alternatifler sorunludur: düz INSERT satır varsa hatayla başarısız olur ve kontrol-sonra-ekle yaklaşımı (SELECT sonra INSERT-veya-UPDATE) **ıraksak koşul** (kontrol ve ekle işlemin arasında başka bir eş zamanlı işlem ekleyebilir, hatalara veya kayıp güncellemelere neden olabilir). `ON CONFLICT` bunu **tek bir deyimde atomik** olarak çözer — ıraksak koşulu ortadan kaldırarak, bu eş zamanlı uygulamalar için önemli doğruluk faydası.

Her iki formu anlamak — **`DO UPDATE`** (ekle veya güncelle, `EXCLUDED` denenen değerleri ifade eder ve mevcut satıra başvurma yeteneği sayaçları artırma gibi mantık için) ve **`DO NOTHING`** (sessizce ekle veya atla) — ortak desenleri kapsar (UPSERT kayıtlar, etkisiz eklemeler, sayaçlar/toplamaları tutma).

Ekle-veya-güncelle sık kullanılan bir işlem olduğu ve bunu doğru ve güvenli şekilde yapmanın (atomik, ıraksak koşullar olmaksızın) eş zamanlı uygulamalarda veri bütünlüğü için önemli olduğu için, UPSERT'i anlamak — ne çözdüğü, atomiklik/ıraksak koşul faydası ve DO UPDATE/DO NOTHING formları — değerli, sık kullanılan PostgreSQL bilgisidir ve bu, sık yapılan bir ihtiyacı başka türlü hata açısından elde kalabilecek şekilde temiz, güvenli bir çözüm sağlayan, gerçek uygulamalar için pratik ve önemli bir özelliktir.