Apakah UPSERT (INSERT ON CONFLICT)?

Question

Accepted Answer

**UPSERT** bermaksud "sisip, atau kemas kini jika ia sudah wujud." PostgreSQL melaksanakannya dengan **`INSERT ... ON CONFLICT`** — sisip satu baris, tetapi jika ia akan melanggar kekangan unik, sebaliknya kemas kini baris sedia ada (atau tidak buat apa-apa). Ia mengendalikan keperluan "sisip-atau-kemas kini" yang lazim secara atomik.

## Masalah yang diselesaikan UPSERT

```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 — sisip atau kemas kini

```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 menyisip akan bertembung pada kekangan unik `email`, Postgres mengemas kini baris sedia ada sebaliknya. **`EXCLUDED`** merujuk kepada nilai yang anda cuba sisip, dan anda juga boleh merujuk baris sedia ada (`users.login_count`) — membolehkan logik seperti menokok pembilang.

## ON CONFLICT DO NOTHING — sisip atau langkau

```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` melangkau baris yang bertembung secara senyap — berguna untuk "sisip jika tiada" tanpa ralat.

## Penggunaan sebenar yang lazim: pembilang dan sisipan idempoten

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

UPSERT (`INSERT ... ON CONFLICT`) ialah ciri PostgreSQL yang penting dan bernilai secara praktikal yang menyelesaikan keperluan "sisip-atau-kemas kini" yang amat lazim dengan kemas dan **selamat**, jadi memahaminya berguna untuk operasi data dunia sebenar.

Keperluan itu — menyisip baris yang mungkin sudah wujud (mengikut kunci unik) — timbul secara berterusan (upsert rekod, pembilang, sisipan idempoten, menyegerakkan data), dan alternatif naif adalah bermasalah: INSERT biasa gagal dengan ralat jika baris wujud, dan pendekatan check-then-insert (SELECT kemudian INSERT-atau-UPDATE) mempunyai **race condition** (transaksi serentak lain boleh menyisip antara semakan dan sisipan anda, menyebabkan ralat atau kemas kini yang hilang). `ON CONFLICT` menyelesaikan ini secara **atomik dalam satu pernyataan** — menghapuskan race condition, yang merupakan faedah ketepatan utamanya untuk aplikasi serentak.

Memahami kedua-dua bentuk — **`DO UPDATE`** (sisip atau kemas kini, dengan `EXCLUDED` merujuk nilai yang dicuba dan keupayaan merujuk baris sedia ada untuk logik seperti menokok pembilang) dan **`DO NOTHING`** (sisip atau langkau secara senyap) — merangkumi corak yang lazim (upsert rekod, sisipan idempoten, menyelenggara pembilang/agregat).

Memandangkan sisip-atau-kemas kini ialah operasi yang kerap dan melakukannya dengan betul dan selamat (atomik, tanpa race condition) penting untuk integriti data dalam aplikasi serentak, memahami UPSERT — apa yang diselesaikannya, faedah atomik/race-condition, dan bentuk DO UPDATE/DO NOTHING — ialah pengetahuan PostgreSQL yang bernilai dan kerap digunakan yang menyediakan penyelesaian bersih dan selamat kepada keperluan lazim yang sebaliknya mudah ralat, menjadikannya ciri praktikal dan penting untuk aplikasi sebenar.