Cad a dhéanann an chlausal RETURNING?

Question

Accepted Answer

Tugann an chlausal **`RETURNING`** deis do staitimintí `INSERT`, `UPDATE`, agus `DELETE` **sonraí a thabhairt ar ais** faoi na sraitheanna ar thug siad tionchar dóibh — go coitianta an ID a ghintear go huathoibríoch tar éis cuir isteach, ach fosta aon cholúin nó luachanna ríofa. Sábhálann sé iarratas ar leith agus is gné dhéanúil PostgreSQL a bhí ann.## RETURNING tar éis INSERT (an ID ginte a fháil)```sql
-- get the auto-generated id back from the insert (no separate SELECT needed)
INSERT INTO users (name, email) VALUES ('Ann', 'ann@x.com')
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
```An úsáid is coitianta: tar éis cuir isteach, is gá duit an **príomh-eochair ghinte** a bheith agat de ghnáth (a úsáid i gcuir isteach i gceangal nó a thabhairt ar ais go dtí an cliant). Tugann `RETURNING id` ar ais go díreach í — gan ghá do iarratas ar leith.## RETURNING le UPDATE agus DELETE```sql
-- 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
```Oibríonn `RETURNING` ar UPDATE (féach ar na luachanna nua) agus DELETE (ceangal cad a bhí bainthe - úsáideach do chartlannú nó dearbhú).## Cén fáth a bhí sé luachmhar: éifeachtúlacht agus atomúlacht```text
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.
```## Patrún comhcheangailte: cuir isteach i dtáblaí gaolmhara```sql
-- 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
```## Cén fáth a bhí sé tábhachtach an RETURNING clausal a thuiscint is luachmhar, in aisce úsáideoir PostgreSQL gné ar bhealach a bhí tábhachtach do éifeachtúlacht agus ceart nuair atá sonraí á athrú.Is é an úsáid níos coitianta agus tábhachtaí **an ID a ghintear ar ais ó INSERT a fháil** — gá in aice ar an bhunúsach (ba bhreá leat an príomh-eochair nua a bheith agat i ndiaidh cuir isteach beagnach i gcónaí, a úsáid i ngníomhartha gaolmhara nó a thabhairt ar ais go dtí an fheidhmchlár), agus soláthraíonn `RETURNING id` go díreach í in aon ráiteas amháin.Gan `RETURNING`, bhéarfá gá do `SELECT` ar leith chun an ID a ghintear a fháil, agus ciallaíonn sin **iomalartú bhreise** agus **riocht rása** dhféadfadh (an SELECT ar leith d'fhéadfadh gan a bheith ábalta do shlí iontaofa a bhaint amach do shraith ar leith i scéalaí comhthráthúla), mar sin tá `RETURNING` níos éifeachtúla agus níos ceart araon.Taobh thuas inserts, oibríonn `RETURNING` le UPDATE (na luachanna nua á fheiceáil i ndiaidh nuashonrú) agus DELETE (ceangal cad a bhí bainthe — úsáideach do chartlannú, logáil, nó dearbhú scriosta).In éineacht le CTEs, cumasaíonn sé patrúin chumhachtacha cosúil le cuir isteach i dtáblaí gaolmhara ag baint úsáide as an ID ar ais tugtha in aon ráiteas amháin.Ó go bhfuil gá leanúnach ann ar luachanna ginte (go háirithe IDanna) a fháil tar éis modhnuithe sonraí, agus ó go soláthraíonn `RETURNING` seo go héifeachtúil agus go huathaim (ag seachaint iarratas bhreise agus coinníollacha rása), is eolas PostgreSQL luachmhar, in aisce úsáideoir an chlausal `RETURNING` a thuiscint atá i gceist go minic, a chuireann cód modhnaithe sonraí i bhfeidhm níos geal, níos éifeachtúla, agus níos ceart — riocht deis phraicticiúil atá i gceist rialta i fíorfheidhmchláranna ag obair le Postgres, go háirithe do an ghá uathúsáideach ar IDanna ginte a aiseolas tar éis inserts.