Apakah UPSERT (INSERT ON CONFLICT)?

Question

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

Masalah yang diselesaikan UPSERT

ON CONFLICT DO UPDATE — sisip atau kemas kini

ON CONFLICT DO NOTHING — sisip atau langkau

Penggunaan sebenar yang lazim: pembilang dan sisipan idempoten

Mengapa ia penting

Soalan berkaitan