RETURNING პუნქტი საშუალებას აძლევს INSERT, UPDATE და DELETE დებულებებს დააბრუნონ მონაცემები იმ რიგების შესახებ, რომლებსაც ისინი გავლენა მოახდინეს — ყველაზე ხშირად ავტომატურად გენერირებული ID ჩასმის შემდეგ, მაგრამ ასევე ნებისმიერი სვეტი ან გამოთვლილი მნიშვნელობა. ეს ზოგავს ცალკე მოთხოვნას და არის მოსახერხებელი 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
ყველაზე გავრცელებული გამოყენება: ჩასმის შემდეგ, ჩვენ ჩვეულებრივ გვჭირდება გენერირებული პირველადი გასაღები (დაკავშირებული ჩასმებში გამოსაყენებლად ან ক্লიენტისთვის დასაბრუნებლად). RETURNING id ის დაუყოვნებლივ უბრუნებს — ცალკე მოთხოვნა არ იყო საჭირო.
-- 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 პუნქტი მოსახერხებელი, ხშირად გამოყენებული PostgreSQL ფიცია, რომელიც ღირებულია მონაცემების მოდიფიკაციისას ეფექტურობისა და სისწორის თვალსაზრისით.
იქვე ყველაზე გავრცელებული და მნიშვნელოვანი გამოყენება არის ავტომატურად გენერირებული ID-ის უკან დაბრუნება INSERT-დან — თითქმის უნივერსალური საჭიროება (თქვენ თითქმის ყოველთვის გჭირდებათ ახალი პირველადი გასაღები ჩასმის შემდეგ, დაკავშირებული ოპერაციებში გამოსაყენებლად ან აპლიკაციაში დასაბრუნებლად), და RETURNING id გთავაზობთ მას პირდაპირ ერთ დებულებაში.
RETURNING-გარეშე, თქვენ დაგჭირდებოდათ ცალკე SELECT, რათა მიიღოთ გენერირებული ID, რაც ნიშნავს დამატებით გამოწოდებას და პოტენციალურ რეზერვის პირობას (ცალკე SELECT შეიძლება არ მოიძებნოს დამუშავებული გარემოებებში თქვენი კონკრეტული რიგი), ამიტომ RETURNING არის მეტი ეფექტური და უფრო სწორი.
ჩასმების გარდა, RETURNING მუშაობს UPDATE-თან (ახალი მნიშვნელობების ხილვა განახლების შემდეგ) და DELETE-თან (დაჭერი რა იყო ამოღებული — სასარგებლო არქივირებისთვის, ჟურნალირებისთვის ან წაშლის დასტიმულად).
CTE-ების সাথে კომბინირებულ, ის ახალსობელ ნიმუშებს ხელმძღვანელობს, როგორიცაა დაკავშირებულ ცხრილებში ჩასმა დაბრუნებული ID-ის გამოყენებით ერთ დებულებაში.
რადგან გენერირებული მნიშვნელობების მიღება (განსაკუთრებით ID-ები) მონაცემების მოდიფიკაციის შემდეგ მუდმივი საჭიროება, და ვინაიდან RETURNING იძლევა ამას ეფექტურად და ატომურად (ზედმეტი მოთხოვნისა და რეზერვის პირობების თავიდან ასაცილებლად), RETURNING პუნქტის გაგება ღირებულია, ხშირად გამოყენებული PostgreSQL ცოდნა, რომელიც მონაცემების მოდიფიკაციის კოდს უფრო სუფთა, უფრო ეფექტური და უფრო სწორი ხდის — პრაქტიკული მოხერხებულობა, რომელიც რუტინულად გამოიყენება Postgres-ის সাথე მუშაობი რეალური აპლიკაციებში, განსაკუთრებით გენერირებული ID-ების წამოშორებისას ჩასმის შემდეგ.