UPSERT (INSERT ON CONFLICT) nedir?

Question

IT Interview Practice · 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.

UPSERT'ün çözdüğü sorun

ON CONFLICT DO UPDATE — ekle veya güncelle

ON CONFLICT DO NOTHING — ekle veya atla

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

Neden önemli

İlgili sorular