RETURNING clause INSERT, UPDATE, اور DELETE statements کو متاثر شدہ صفوں کے بارے میں ڈیٹا واپس کرنے دیتا ہے — سب سے عام طور پر ایک insert کے بعد خودکار طریقے سے تیار کی گئی ID، لیکن کسی بھی column یا calculated 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 پر کام کرتا ہے (نئی قیمتیں دیکھیں) اور 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 کی ایک سہولت بخش، بار بار استعمال ہونے والی خصوصیت ہے جو ڈیٹا میں ترمیم کرتے وقت کارکردگی اور درستگی کے لیے قیمتی ہے۔
اس کا سب سے عام اور اہم استعمال INSERT سے خودکار طریقے سے تیار شدہ ID واپس حاصل کرنا ہے — ایک تقریباً عام ضرورت (آپ تقریباً ہمیشہ نئی primary key چاہتے ہیں insert کے بعد، متعلقہ operations میں استعمال کرنے یا application کو واپس کرنے کے لیے)، اور RETURNING id یہ براہ راست ایک statement میں فراہم کرتا ہے۔
RETURNING کے بغیر، آپ کو تیار شدہ ID حاصل کرنے کے لیے ایک الگ SELECT کی ضرورت ہوگی، جس کا مطلب ایک اضافی round-trip اور ایک ممکنہ race condition ہے (الگ SELECT concurrent scenarios میں قابل اعتماد طریقے سے آپ کی مخصوص row حاصل نہیں کر سکتا)، تو RETURNING زیادہ موثر اور زیادہ درست دونوں ہے۔
Inserts سے آگے، RETURNING UPDATE کے ساتھ کام کرتا ہے (update کے بعد نئی قیمتیں دیکھنا) اور DELETE کے ساتھ (ہٹائی گئی چیزوں کو capture کرنا — archiving، logging، یا deletions تصدیق کے لیے مفید)۔
CTEs کے ساتھ ملاکر، یہ طاقتور patterns کو فعال کرتا ہے جیسے ایک statement میں متعلقہ tables میں insert کرنا واپسی ID استعمال کرتے ہوئے۔
چونکہ ڈیٹا میں ترمیم کے بعد generated values (خاص طور پر IDs) حاصل کرنا ایک مسلسل ضرورت ہے، اور چونکہ RETURNING یہ موثر طریقے سے اور atomically فراہم کرتا ہے (اضافی queries اور race conditions سے بچتے ہوئے)، RETURNING clause کو سمجھنا قیمتی، بار بار استعمال ہونے والے PostgreSQL علم ہے جو ڈیٹا میں ترمیم کا code صاف، زیادہ موثر، اور زیادہ درست بناتا ہے — ایک عملی سہولت جو Postgres کے ساتھ کام کرنے والی حقیقی applications میں معمول کے مطابق استعمال ہوتی ہے، خاص طور پر inserts کے بعد generated IDs حاصل کرنے کی سر্वجنین ضرورت کے لیے۔