RETURNING clause INSERT, UPDATE, आणि DELETE स्टेटमेंट्स ला डेटा परत करू देतो ज्या ओळींवर त्यांनी परिणाम केला — बहुतेक वेळा insert नंतर auto-generated ID, परंतु कोणतेही स्तंभ किंवा 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 मध्ये वापरण्यासाठी किंवा क्लायंटला परत करण्यासाठी). 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 वर कार्य करतो (नवीन मूल्ये पहा) आणि DELETE (काढून टाकलेले कॅप्चर करा — आर्काइव्हिंग किंवा पुष्टी करण्यासाठी उपयोगी).
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 वैशिष्ट्य आहे जी डेटा सुधारित करताना कार्यक्षमता आणि शुद्धतेसाठी मूल्यवान आहे.
त्याचा सर्वात सामान्य आणि महत्वाचा वापर INSERT मधून auto-generated ID परत मिळवणे आहे — एक सर्वव्यापी गरज (insert नंतर तुम्हाला जवळजवळ नेहमीच नवीन primary key हवी असते, संबंधित ऑपरेशन्समध्ये वापरण्यासाठी किंवा application ला परत करण्यासाठी), आणि RETURNING id हे एक statement मध्ये थेट प्रदान करतो.
RETURNING शिवाय, तुम्हाला generated ID मिळवण्यासाठी वेगळे SELECT ची आवश्यकता असेल, ज्याचा अर्थ अतिरिक्त round-trip आणि संभाव्य race condition (वेगळे SELECT तुमच्या विशिष्ट ओळ concurrent situations मध्ये विश्वसनीयपणे पुनर्प्राप्त करू शकत नाही), म्हणून RETURNING दोन्ही अधिक कार्यक्षम आणि अधिक योग्य आहे.
Inserts च्या पलीकडे, RETURNING UPDATE (update नंतर नवीन मूल्ये पाहणे) आणि DELETE (काढून टाकलेले कॅप्चर करा — आर्काइव्हिंग, logging, किंवा deletions च्या पुष्टीसाठी उपयोगी) सह कार्य करतो.
CTEs सह संयुक्त, हे शक्तिशाली नमुने सक्षम करतो जसे की संबंधित सारणींमध्ये insert करणे returned ID वापरून एक single statement मध्ये.
डेटा modifications नंतर generated values (विशेषतः IDs) मिळवणे सतत गरज असल्याने, आणि RETURNING हे कार्यक्षमतेने आणि atomically (अतिरिक्त queries आणि race conditions टाळून) प्रदान करल्याने, RETURNING clause समजून घेणे मूल्यवान, वारंवार-लागू PostgreSQL ज्ञान आहे जे data-modification code स्वच्छ, अधिक कार्यक्षम, आणि अधिक योग्य बनवतो — एक व्यावहारिक सुविधा जी Postgres सह काम करणाऱ्या वास्तविक applications मध्ये दिनचर्याप्रकारे वापरली जाते, विशेषतः inserts नंतर generated IDs पुनर्प्राप्त करण्याच्या सर्वव्यापी गरजेसाठी.