RETURNING-lauseke mahdollistaa INSERT-, UPDATE- ja DELETE-lauseisiin palauttaa tietoa muuttamistaan riveistä — useimmiten automaattisesti luotu tunnus lisäyksen jälkeen, mutta myös minkä tahansa sarakkeet tai lasketut arvot. Se säästää erillisen kyselyn ja on kätevä PostgreSQL-ominaisuus.
-- 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
Tärkein käyttötapaus: lisäyksen jälkeen tarvitset yleensä luodun pääavaimen (käytettäväksi liittyvissä lisäyksissä tai palautettavaksi asiakkaalle). RETURNING id palauttaa sen suoraan — ei tarvetta erilliselle kyselylle.
-- 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 toimii UPDATE:ssa (katso uudet arvot) ja DELETE:ssä (kaappaa mitä poistettiin — hyödyllinen arkistointiin tai poistamisen vahvistamiseen).
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-lauseke on kätevä, usein käytetty PostgreSQL-ominaisuus, joka on arvokas tietojen muokkaamisen tehokkuuden ja oikeellisuuden kannalta.
Sen tärkein ja yleisin käyttötapaus on automaattisesti luodun tunnuksen saaminen takaisin INSERT:stä — lähes universaalinen tarve (haluat lähes aina uuden pääavaimen lisäyksen jälkeen, käytettäväksi liittyvissä toiminnoissa tai palautettavaksi sovellukselle), ja RETURNING id toimittaa sen suoraan yhdessä lauseessa.
Ilman RETURNING:ia tarvitset erillisen SELECT:n luodun tunnuksen saamiseksi, mikä tarkoittaa ylimääräistä liuennonta ja potentiaalista kilpailutilaongelmaa (erillinen SELECT ei välttämättä palauta luotettavasti sinun spesifiä riviä samanaikaisissa tilanteissa), joten RETURNING on sekä tehokkaampi että oikeempi.
Lisäyksen lisäksi RETURNING toimii UPDATE:n kanssa (nähdään uudet arvot päivityksen jälkeen) ja DELETE:n kanssa (kaappaa mitä poistettiin — hyödyllinen arkistointiin, loggaukseen tai poistojen vahvistamiseen).
Yhdessä CTE:iden kanssa se mahdollistaa tehokkaat kuviot, kuten liittyvien taulukoiden lisäämisen käyttäen palautettua tunnusta yhdessä lauseessa.
Koska luotujen arvojen saaminen (erityisesti tunnuksista) tiedon muokkauksien jälkeen on jatkuva tarve, ja koska RETURNING toimittaa tämän tehokkaasti ja atomaarisesti (välttäen ylimääräisiä kyselyitä ja kilpailutiloja), RETURNING-lausekkeen ymmärtäminen on arvokasta, usein käytettyä PostgreSQL-tietoa, joka tekee tiedon muokkaamisen koodista puhtaampaa, tehokkaamaa ja oikeempaa — käytännön kätevyyttä, jota käytetään säännöllisesti todellisissa sovelluksissa, joissa työskennellään Postgresin kanssa, erityisesti luotujen tunnuksien noutamisen pysyvän tarpeen osalta lisäysten jälkeen.