Kifungu cha RETURNING kinaruhusu taarifa za INSERT, UPDATE, na DELETE kurudisha data kuhusu safu zilizoathiriwa — mara nyingi zaidi kitambulisho kilichozalishwa kiotomatiki baada ya insert, lakini pia safu wima zozote au thamani zilizokokotwa. Inaokoa swali tofauti na ni kipengele rahisi cha 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
Matumizi ya kawaida zaidi: baada ya kuingiza, kwa kawaida unahitaji primary key iliyozalishwa (kuitumia katika inserts zinazohusiana au kuirudisha kwa mteja). RETURNING id inairudisha moja kwa moja — hakuna haja ya swali tofauti.
-- 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 inafanya kazi kwenye UPDATE (kuona thamani mpya) na DELETE (kunasa kilichoondolewa — yenye manufaa kwa kuhifadhi au kuthibitisha).
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
Kifungu cha RETURNING ni kipengele rahisi, kinachotumika mara kwa mara cha PostgreSQL chenye thamani kwa ufanisi na usahihi unapobadilisha data.
Matumizi yake ya kawaida na muhimu zaidi ni kupata kitambulisho kilichozalishwa kiotomatiki kutoka kwa INSERT — hitaji la karibu kila wakati (karibu kila mara unataka primary key mpya baada ya kuingiza, kuitumia katika shughuli zinazohusiana au kuirudisha kwa programu), na RETURNING id inairudisha moja kwa moja katika taarifa moja.
Bila RETURNING, ungehitaji SELECT tofauti kupata kitambulisho kilichozalishwa, ambayo inamaanisha round-trip ya ziada na race condition inayoweza kutokea (SELECT tofauti inaweza isipate safu yako mahususi kwa uhakika katika hali zinazoendana), hivyo RETURNING ina ufanisi zaidi na ni sahihi zaidi.
Zaidi ya inserts, RETURNING inafanya kazi na UPDATE (kuona thamani mpya baada ya sasisho) na DELETE (kunasa kilichoondolewa — yenye manufaa kwa kuhifadhi, kuandika kumbukumbu, au kuthibitisha mafutaji).
Ikichanganywa na CTEs, inawezesha mifumo yenye nguvu kama kuingiza katika jedwali zinazohusiana ikitumia kitambulisho kilichorudishwa katika taarifa moja.
Kwa kuwa kupata thamani zilizozalishwa (hasa vitambulisho) baada ya mabadiliko ya data ni hitaji la mara kwa mara, na kwa kuwa RETURNING inatoa hii kwa ufanisi na kwa njia ya atomic (ikiepuka maswali ya ziada na race conditions), kuelewa kifungu cha RETURNING ni maarifa yenye thamani ya PostgreSQL yanayotumika mara kwa mara yanayofanya msimbo wa kubadilisha-data kuwa safi zaidi, wenye ufanisi zaidi, na sahihi zaidi — urahisi wa kivitendo unaotumika mara kwa mara katika programu halisi zinazofanya kazi na Postgres, hasa kwa hitaji la kila mahali la kupata vitambulisho vilivyozalishwa baada ya inserts.