RETURNING clause ले के गर्छ?

Question

Accepted Answer

**`RETURNING`** clause ले `INSERT`, `UPDATE`, र `DELETE` statements लाई **डेटा फर्काउन** दिन्छ जुन पङ्क्तिहरूलाई असर गरेको छ — सबैभन्दा सामान्य रूपमा insert पछि auto-generated ID, तर कुनै पनि स्तम्भ वा computed values पनि। यो अलग प्रश्न बचाउँछ र PostgreSQL को एक सुविधाजनक सुविधा हो।

## INSERT पछि RETURNING (generated ID प्राप्त गर्नुहोस्)

```sql
-- get the auto-generated id back from the insert (no separate SELECT needed)
INSERT INTO users (name, email) VALUES ('Ann', 'ann@x.com')
RETURNING id;                        -- returns the new id

-- return multiple columns or all of them
INSERT INTO users (name) VALUES ('Bob')
RETURNING id, name, created_at;      -- including DB-generated values
INSERT INTO users (name) VALUES ('Carol') RETURNING *;   -- the whole row
```

सबैभन्दा सामान्य प्रयोग: insert गरेपछि, तपाईलाई सामान्यतः **generated primary key** चाहिन्छ (सम्बन्धित inserts मा प्रयोग गर्न वा क्लाइन्टलाई फर्काउन)। `RETURNING id` यो सीधै फर्काएँ — अलग प्रश्नको आवश्यकता छैन।

## UPDATE र DELETE सँग RETURNING

```sql
-- see what was updated
UPDATE products SET price = price * 1.1 WHERE category = 'books'
RETURNING id, name, price;           -- the NEW values after the update

-- capture deleted rows (e.g. for archiving/logging)
DELETE FROM sessions WHERE expired = true
RETURNING id, user_id;               -- which rows were deleted
```

`RETURNING` UPDATE मा काम गर्छ (नयाँ मानहरू हेर्नुहोस्) र DELETE मा (हटाइएको कुरा क्याप्चर गर्नुहोस् — आर्काइभिङ् वा पुष्टिकरणको लागि उपयोगी)।

## किन यो मूल्यवान छ: दक्षता र atomicity

```text
Without RETURNING:
  INSERT ...; then a separate SELECT to get the id → TWO round-trips, and a potential
  race (the SELECT might not reliably get YOUR row).
With RETURNING:
  one statement returns the affected data atomically → fewer round-trips, no race.
```

## एक संयुक्त प्याटर्न: सम्बन्धित तालिकामा insert गर्नुहोस्

```sql
-- use a CTE with RETURNING to insert and use the id in the same statement
WITH new_user AS (
  INSERT INTO users (name) VALUES ('Ann') RETURNING id
)
INSERT INTO profiles (user_id, bio)
SELECT id, 'Hello' FROM new_user;    -- use the returned id directly
```

## यो किन महत्त्वपूर्ण छ

`RETURNING` clause एक सुविधाजनक, बारम्बार प्रयोग गरिने PostgreSQL सुविधा हो जुन डेटा परिमार्जन गर्दा दक्षता र शुद्धताको लागि मूल्यवान छ।

यसको सबैभन्दा सामान्य र महत्त्वपूर्ण प्रयोग **INSERT बाट auto-generated ID फर्काएँ** हो — एक सर्वव्यापी आवश्यकता (तपाई लगभग सधैं नयाँ primary key चाहनुहुन्छ insert गरेपछि, सम्बन्धित अपरेशनहरूमा प्रयोग गर्न वा अनुप्रयोगलाई फर्काउन), र `RETURNING id` यो सीधै एक कथनमा प्रदान गर्छ।

`RETURNING` बिना, तपाईलाई generated ID प्राप्त गर्न एक अलग `SELECT` चाहिन्छ, जसको अर्थ **extra round-trip** र एक सम्भावित **race condition** (अलग SELECT ले समवर्ती परिस्थितिहरूमा आपको विशेष पङ्क्तिलाई भरपर्दो रूपमा पुनः प्राप्त गर्न सक्दैन), त्यसैले `RETURNING` अधिक दक्ष र अधिक सही दुवै छ।

inserts भन्दा बाहिर, `RETURNING` UPDATE (update पछि नयाँ मानहरू हेरेर) र DELETE (हटाइएको कुरा क्याप्चर गर्नुहोस् — आर्काइभिङ्, logging, वा deletions पुष्टि गर्नको लागि उपयोगी) सँग काम गर्छ।

CTEs सँग संयुक्त, यो शक्तिशाली प्याटर्नहरू सक्षम गर्छ जस्तै एक कथनमा returned ID प्रयोग गरेर सम्बन्धित तालिकामा insert गर्नु।

डेटा परिमार्जन पछि generated मानहरू (विशेष गरी IDs) प्राप्त गर्नु एक निरन्तर आवश्यकता छ, र `RETURNING` यो दक्षतापूर्वक र atomically प्रदान गर्छ (अतिरिक्त प्रश्न र race conditions बचाएर), डेटा-परिमार्जन कोडलाई सफा, अधिक दक्ष र अधिक सही बनाउने `RETURNING` clause बुझ्नु मूल्यवान, बारम्बार-लागू PostgreSQL ज्ञान हो — एक व्यावहारिक सुविधा जुन Postgres सँग काम गर्ने वास्तविक अनुप्रयोगहरूमा दिनचर्या रूपमा प्रयोग गरिन्छ, विशेष गरी inserts पछि generated IDs को सर्वव्यापी आवश्यकताको लागि।