Apa itu UPSERT (INSERT ON CONFLICT)?

Question

Accepted Answer

**UPSERT** berarti "insert, atau update jika sudah ada." PostgreSQL mengimplementasikan ini dengan **`INSERT ... ON CONFLICT`** — insert sebuah baris, tetapi jika melanggar unique constraint, update baris yang sudah ada (atau tidak lakukan apa-apa). Ini menangani kebutuhan umum "insert-atau-update" secara atomic.

## Masalah yang UPSERT selesaikan

```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 — insert atau update

```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
```

Jika insert akan conflict pada unique constraint `email`, Postgres mengupdate baris yang sudah ada. **`EXCLUDED`** mengacu pada nilai yang Anda coba insert, dan Anda juga bisa mereferensikan baris yang sudah ada (`users.login_count`) — memungkinkan logic seperti increment counter.

## ON CONFLICT DO NOTHING — insert atau skip

```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` secara diam-diam melewatkan baris yang conflict — berguna untuk "insert jika tidak ada" tanpa error.

## Kegunaan umum yang nyata: counter dan insert yang idempotent

```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;
```

## Mengapa ini penting

UPSERT (`INSERT ... ON CONFLICT`) adalah fitur PostgreSQL yang penting dan praktis yang menyelesaikan kebutuhan "insert-atau-update" yang sangat umum dengan bersih dan **aman**, jadi memahaminya berguna untuk operasi data dunia nyata.

Kebutuhan — insert baris yang mungkin sudah ada (berdasarkan unique key) — muncul terus-menerus (upserting record, counter, insert idempotent, sinkronisasi data), dan alternatif naif bermasalah: plain INSERT gagal dengan error jika baris sudah ada, dan pendekatan check-then-insert (SELECT lalu INSERT-atau-UPDATE) memiliki **race condition** (transaksi concurrent lain bisa insert antara check dan insert Anda, menyebabkan error atau lost update). `ON CONFLICT` menyelesaikan ini **secara atomic dalam satu statement** — menghilangkan race condition, yang merupakan manfaat kebenaran kuncinya untuk aplikasi concurrent.

Memahami kedua bentuk — **`DO UPDATE`** (insert atau update, dengan `EXCLUDED` mereferensikan nilai yang dicoba dan kemampuan mereferensikan baris yang sudah ada untuk logic seperti increment counter) dan **`DO NOTHING`** (insert atau skip diam-diam) — mencakup pola umum (upserting record, insert idempotent, maintain counter/aggregate).

Karena insert-atau-update adalah operasi yang sering dan melakukannya dengan benar dan aman (atomic, tanpa race condition) penting untuk data integrity dalam aplikasi concurrent, memahami UPSERT — apa yang diselesaikannya, manfaat atomicity/race-condition, dan bentuk DO UPDATE/DO NOTHING — adalah pengetahuan PostgreSQL yang berharga, sering diterapkan yang menyediakan solusi bersih dan aman untuk kebutuhan umum yang sebaliknya error-prone, menjadikannya fitur praktis dan penting untuk aplikasi nyata.