UPSERT (INSERT ON CONFLICT) क्या है?

Question

Accepted Answer

**UPSERT** का अर्थ है "insert करें, या यदि यह पहले से मौजूद है तो update करें।" PostgreSQL इसे **`INSERT ... ON CONFLICT`** के साथ लागू करता है — एक row insert करें, लेकिन यदि यह किसी unique constraint का उल्लंघन करेगा, तो इसके बजाय मौजूदा row को update करें (या कुछ न करें)। यह सामान्य "insert-या-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 पर conflict होगा, तो 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` conflicting rows को चुपचाप skip कर देता है — error के बिना "insert if not present" के लिए उपयोगी।

## एक सामान्य वास्तविक उपयोग: 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 विशेषता है जो बहुत सामान्य "insert-या-update" ज़रूरत को स्वच्छ और **सुरक्षित** रूप से हल करती है, इसलिए इसे समझना वास्तविक-दुनिया के data operations के लिए उपयोगी है।

ज़रूरत — एक row insert करना जो पहले से मौजूद हो सकती है (किसी unique key द्वारा) — लगातार उत्पन्न होती है (records upsert करना, counters, idempotent inserts, data sync करना), और सहज विकल्प समस्याग्रस्त हैं: एक plain INSERT row के मौजूद होने पर error के साथ विफल हो जाता है, और check-then-insert दृष्टिकोण (SELECT फिर INSERT-या-UPDATE) में एक **race condition** होती है (एक अन्य concurrent transaction आपके check और आपके insert के बीच insert कर सकती है, जिससे errors या lost updates होते हैं)। `ON CONFLICT` इसे **एक single 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-या-update एक बार-बार होने वाला operation है और इसे सही और सुरक्षित रूप से करना (atomically, race conditions के बिना) concurrent applications में data integrity के लिए मायने रखता है, UPSERT को समझना — यह क्या हल करता है, atomicity/race-condition लाभ, और DO UPDATE/DO NOTHING रूप — मूल्यवान, बार-बार लागू होने वाला PostgreSQL ज्ञान है जो एक सामान्य ज़रूरत का स्वच्छ, सुरक्षित समाधान प्रदान करता है जो अन्यथा त्रुटि-प्रवण है, जिससे यह वास्तविक applications के लिए एक व्यावहारिक, महत्वपूर्ण विशेषता बन जाती है।