UPSERT (INSERT ON CONFLICT) भनेको के हो?

Question

Accepted Answer

**UPSERT** को अर्थ "insert गर, वा यदि यो पहिले नै अवस्थित छ भने update गर।" PostgreSQL यसलाई **`INSERT ... ON CONFLICT`** को साथ लागु गर्दछ — एक पङ्क्ति insert गर, तर यदि यो एक unique constraint उल्लङ्घन गर्दछ भने, यसको सट्टा अवस्थित पङ्क्तिलाई 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
```

यदि inserting गर्न जाँदा `email` unique constraint मा conflict हुन्छ भने, Postgres अवस्थित पङ्क्तिलाई update गर्दछ। **`EXCLUDED`** ले तपाईंले insert गर्न प्रयास गरेको मानहरूलाई सन्दर्भ गर्दछ, र तपाईं अवस्थित पङ्क्तिलाई पनि सन्दर्भ गर्न सक्नुहुन्छ (`users.login_count`) — एक counter increment गर्ने जस्ता तर्कलाई सक्षम बनाउँदै।

## ON CONFLICT DO NOTHING — insert वा छोड्

```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` conflict गर्ने पङ्क्तिहरूलाई निर्बाध रूपमा छोड्दछ — "यदि अवस्थित छैन भने insert गर" को लागि त्रुटिहरू बिना उपयोगी।

## एक सामान्य वास्तविक उपयोग: 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-or-update" आवश्यकतालाई स्वच्छ र **सुरक्षित** तरिकाले समाधान गर्दछ, त्यसैले यसलाई बुझ्न वास्तविक डेटा सञ्चालनको लागि उपयोगी छ।

आवश्यकता — एक पङ्क्ति insert गर्न जो पहिले नै अवस्थित हुन सक्छ (एक unique key द्वारा) — निरन्तर देखा पर्दछ (upsert गर्ने records, counters, idempotent inserts, डेटा sync गर्न), र सरल विकल्पहरू समस्याग्रस्त छन्: एक सादा INSERT पङ्क्ति पहिले नै अवस्थित छ भने त्रुटि सहित विफल हुन्छ, र check-then-insert दृष्टिकोण (SELECT त्यसपछी INSERT-or-UPDATE) एक **race condition** छ (अर्को concurrent transaction तपाईंको check र तपाईंको insert को बीचमा insert गर्न सक्छ, त्रुटि वा हराइएको अद्यावधिक कारण गर्दै)। `ON CONFLICT` यसलाई **atomically एक एकल statement मा** समाधान गर्दछ — race condition लाई हटाउँदै, जो concurrent applications को लागि यसको मुख्य शुद्धता लाभ हो।

दुवै रूप बुझ्न — **`DO UPDATE`** (insert वा update, `EXCLUDED` ले प्रयास गरेको मान सन्दर्भ गर्दै र counter increment गर्ने जस्ता तर्कको लागि अवस्थित पङ्क्तिलाई सन्दर्भ गर्ने क्षमता) र **`DO NOTHING`** (insert वा निर्बाध रूपमा छोड्) — सामान्य नमूनाहरू कभर गर्दछ (upsert गर्ने records, idempotent inserts, counters/aggregates कायम राख्न)।

Yadि insert-or-update एक बारम्बार सञ्चालन हो र यसलाई सही र सुरक्षित तरिकाले गर्न (atomically, race conditions बिना) concurrent applications मा डेटा integrity को लागि महत्त्वपूर्ण हुन्छ, UPSERT बुझ्न — यो के समाधान गर्दछ, atomicity/race-condition लाभ, र DO UPDATE/DO NOTHING रूपहरू — मूल्यवान, बारम्बार-प्रयोग गरिने PostgreSQL ज्ञान हो जो एक सामान्य आवश्यकतामा एक स्वच्छ, सुरक्षित समाधान प्रदान गर्दछ जो अन्यथा त्रुटि-प्रवण हुन्छ, यसलाई वास्तविक applications को लागि व्यावहारिक, महत्त्वपूर्ण सुविधा बनाइदै।