UPSERT (INSERT ON CONFLICT) کیا ہے؟

Question

Accepted Answer

**UPSERT** کا مطلب ہے "insert کرو، یا اگر پہلے سے موجود ہے تو update کرو۔" PostgreSQL اسے **`INSERT ... ON CONFLICT`** کے ذریعے نافذ کرتا ہے — ایک row insert کرو، لیکن اگر اس سے کوئی unique constraint کی خلاف ورزی ہوتی ہو، تو اس کے بجائے موجودہ row کو update کرو (یا کچھ نہ کرو)۔ یہ عام "insert-or-update" کی ضرورت کو atomically سنبھالتا ہے۔

## وہ مسئلہ جو 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 — insert یا 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
```

اگر insert کرنے سے `email` unique constraint پر تصادم ہو، تو Postgres اس کے بجائے موجودہ row کو update کر دیتا ہے۔ **`EXCLUDED`** ان values کا حوالہ دیتا ہے جنہیں آپ نے insert کرنے کی کوشش کی تھی، اور آپ موجودہ row (`users.login_count`) کا بھی حوالہ دے سکتے ہیں — جس سے counter بڑھانے جیسی logic ممکن ہوتی ہے۔

## ON CONFLICT DO NOTHING — insert یا 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` خاموشی سے تصادم کرنے والی rows کو skip کر دیتا ہے — "insert if not present" کے لیے بغیر errors کے مفید ہے۔

## ایک عام حقیقی استعمال: counters اور idempotent inserts

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

## یہ کیوں اہم ہے

UPSERT (`INSERT ... ON CONFLICT`) ایک اہم، عملی طور پر قیمتی PostgreSQL feature ہے جو نہایت عام "insert-or-update" کی ضرورت کو صاف ستھرے اور **محفوظ** طریقے سے حل کرتا ہے، اس لیے اسے سمجھنا حقیقی دنیا کی data operations کے لیے مفید ہے۔

یہ ضرورت — ایک ایسی row insert کرنا جو پہلے سے موجود ہو سکتی ہے (کسی unique key کے ذریعے) — مسلسل پیش آتی ہے (records کا upsert کرنا، counters، idempotent inserts، data کو sync کرنا)، اور سادہ متبادل مسائل سے بھرپور ہیں: ایک plain INSERT اگر row موجود ہو تو error کے ساتھ ناکام ہو جاتا ہے، اور check-then-insert طریقہ (SELECT پھر INSERT-or-UPDATE) میں ایک **race condition** ہوتی ہے (کوئی دوسرا concurrent transaction آپ کے check اور آپ کے insert کے درمیان insert کر سکتا ہے، جس سے errors یا lost updates ہو سکتے ہیں)۔ `ON CONFLICT` اسے **ایک ہی statement میں atomically** حل کرتا ہے — race condition کو ختم کرتے ہوئے، جو concurrent applications کے لیے اس کا کلیدی correctness فائدہ ہے۔

دونوں شکلوں کو سمجھنا — **`DO UPDATE`** (insert یا update، جس میں `EXCLUDED` کوشش کی گئی values کا حوالہ دیتا ہے اور counters بڑھانے جیسی logic کے لیے موجودہ row کا حوالہ دینے کی صلاحیت ہوتی ہے) اور **`DO NOTHING`** (insert یا خاموشی سے skip) — عام patterns کا احاطہ کرتا ہے (records کا upsert، idempotent inserts، counters/aggregates کو برقرار رکھنا)۔

چونکہ insert-or-update ایک کثرت سے پیش آنے والا operation ہے اور اسے درست اور محفوظ طریقے سے (atomically، بغیر race conditions کے) کرنا concurrent applications میں data integrity کے لیے اہم ہے، اس لیے UPSERT کو سمجھنا — یہ کیا حل کرتا ہے، atomicity/race-condition کا فائدہ، اور DO UPDATE/DO NOTHING شکلیں — قیمتی، کثرت سے استعمال ہونے والا PostgreSQL علم ہے جو ایک عام ضرورت کا صاف ستھرا، محفوظ حل فراہم کرتا ہے جو بصورت دیگر error-prone ہوتی ہے، جو اسے حقیقی applications کے لیے ایک عملی، اہم feature بناتا ہے۔