RETURNING clause INSERT, UPDATE और DELETE statements को उनके द्वारा प्रभावित rows के बारे में data वापस करने देता है — सबसे आमतौर पर insert के बाद auto-generated ID, लेकिन कोई भी columns या computed values भी। यह एक अलग query बचाता है और एक सुविधाजनक PostgreSQL विशेषता है।
-- get the auto-generated id back from the insert (no separate SELECT needed)
INSERT INTO users (name, email) VALUES ('Ann', '[email protected]')
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 में उपयोग करने या client को वापस करने के लिए)। RETURNING id इसे सीधे वापस देता है — किसी अलग query की ज़रूरत नहीं।
-- 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 (नए values देखें) और DELETE (हटाई गई चीज़ें capture करें — archiving या पुष्टि के लिए उपयोगी) पर काम करता है।
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.
-- 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 विशेषता है जो data संशोधित करते समय efficiency और correctness के लिए मूल्यवान है।
इसका सबसे आम और महत्वपूर्ण उपयोग INSERT से auto-generated ID वापस पाना है — एक लगभग सार्वभौमिक ज़रूरत (insert करने के बाद आप लगभग हमेशा नई primary key चाहते हैं, संबंधित operations में उपयोग करने या application को वापस करने के लिए), और RETURNING id इसे एक statement में सीधे प्रदान करता है।
RETURNING के बिना, आपको generated ID पाने के लिए एक अलग SELECT की ज़रूरत होगी, जिसका अर्थ है एक अतिरिक्त round-trip और एक संभावित race condition (अलग SELECT concurrent परिदृश्यों में आपकी विशिष्ट row को विश्वसनीय रूप से retrieve नहीं कर सकता), इसलिए RETURNING अधिक कुशल और अधिक सही दोनों है।
inserts से परे, RETURNING UPDATE (update के बाद नए values देखना) और DELETE (हटाई गई चीज़ें capture करना — archiving, logging या deletions की पुष्टि के लिए उपयोगी) के साथ काम करता है।
CTEs के साथ संयुक्त, यह एक single statement में returned ID का उपयोग करके संबंधित tables में insert करने जैसे शक्तिशाली patterns को सक्षम करता है।
चूँकि data संशोधनों के बाद generated values (विशेष रूप से IDs) पाना एक निरंतर ज़रूरत है, और चूँकि RETURNING इसे कुशलता और atomically प्रदान करता है (अतिरिक्त queries और race conditions से बचना), RETURNING clause को समझना मूल्यवान, बार-बार लागू होने वाला PostgreSQL ज्ञान है जो data-modification code को स्वच्छ, अधिक कुशल और अधिक सही बनाता है — एक व्यावहारिक सुविधा जिसका उपयोग Postgres के साथ काम करने वाले वास्तविक applications में नियमित रूप से होता है, विशेष रूप से inserts के बाद generated IDs को retrieve करने की सर्वव्यापी ज़रूरत के लिए।