RETURNING clause INSERT, UPDATE, এবং DELETE statements কে data ফেরত দিতে দেয় যা তারা প্রভাবিত করা rows সম্পর্কে — সাধারণত একটি 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 বা confirming এর জন্য উপকারী)।
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 সংশোধন করার সময় দক্ষতা এবং সঠিকতার জন্য মূল্যবান।
এর সবচেয়ে সাধারণ এবং গুরুত্বপূর্ণ ব্যবহার হল একটি INSERT থেকে auto-generated ID ফেরত পাওয়া — একটি সর্বজনীন প্রয়োজন (আপনি প্রায় সর্বদা insert করার পরে নতুন primary key চান, সংযুক্ত অপারেশনে ব্যবহার করতে বা application এ ফেরত দিতে), এবং RETURNING id এটি সরাসরি একটি statement এ প্রদান করে।
RETURNING ছাড়া, আপনাকে generated ID পেতে একটি আলাদা SELECT প্রয়োজন হবে, যার অর্থ একটি অতিরিক্ত round-trip এবং একটি সম্ভাব্য race condition (আলাদা SELECT সম্ভবত concurrent scenarios এ আপনার নির্দিষ্ট row নির্ভরযোগ্যভাবে পুনরুদ্ধার করতে পারে না), তাই RETURNING আরও দক্ষ এবং আরও সঠিক উভয়ই।
Inserts এর বাইরে, RETURNING UPDATE এর সাথে কাজ করে (একটি update এর পরে নতুন values দেখা) এবং DELETE সহ (কী সরানো হয়েছে তা capture করুন — archiving, logging, বা deletions confirming এর জন্য উপকারী)।
CTEs এর সাথে সংযুক্ত, এটি একটি statement এ returned ID ব্যবহার করে সংযুক্ত tables এ inserting এর মতো শক্তিশালী patterns সক্ষম করে।
যেহেতু generated values (বিশেষত IDs) পাওয়া data modifications এর পরে একটি ক্রমাগত প্রয়োজন, এবং যেহেতু RETURNING এটি দক্ষতার সাথে এবং atomically প্রদান করে (অতিরিক্ত queries এবং race conditions এড়িয়ে), RETURNING clause বোঝা মূল্যবান, ঘন ঘন-প্রয়োগকৃত PostgreSQL জ্ঞান যা data-modification code পরিষ্কার, আরও দক্ষ, এবং আরও সঠিক করে তোলে — একটি ব্যবহারিক সুবিধা যা PostgreSQL এর সাথে কাজ করা real applications এ রুটিনভাবে ব্যবহৃত হয়, বিশেষত inserts এর পরে generated IDs পুনরুদ্ধার করার সর্বব্যাপী প্রয়োজনের জন্য।