X'inhu l-clause RETURNING?

Question

Accepted Answer

Il-clause **`RETURNING`** tippermetti lill-statements `INSERT`, `UPDATE`, u `DELETE` **jirritornaw data** dwar ir-rows li affettaw — l-aktar komuni l-ID ġenerat awtoматikament wara insert, iżda wkoll kwalunkwe kolonni jew valuri kalkulati. Din tiffranka query separata u hija feature konvenjenti ta' PostgreSQL.

## RETURNING wara INSERT (ikseb l-ID ġenerat)

```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
```

L-użu l-aktar komuni: wara li tqiegħed, inti normalment għandek bżonn il-**primary key ġenerat** (biex tuża f'inserts relatati jew tirritorna lill-kliyent). `RETURNING id` jirritornaha direttament — m'hemmx bżonn query separata.

## RETURNING ma UPDATE u 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
```

`RETURNING` jaħdem fuq UPDATE (ara l-valuri ġodda) u DELETE (aqbad dak li tnegħa — utli għal archiving jew konferma).

## Għaliex hu valwuż: effiċjenza u atomicity

```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.
```

## Pattern kombinat: qiegħed f'tabelli relatati

```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
```

## Għaliex hu importanti

Il-clause `RETURNING` hija feature konvenjenti ta' PostgreSQL, li tintuża ta' spiss u li tkun valwuża għall-effiċjenza u l-korrettezza meta taqleb data.

L-użu l-aktar komuni u importanti tiegħu huwa li taqbad l-**ID ġenerat awtoматikament minn INSERT** — bżonn quasi universali (inti kważi dejjem trid il-primary key ġdid wara li tqiegħed, biex tuża f'operazzjonijiet relatati jew tirritorna lejn l-applikazzjoni), u `RETURNING id` jipprovdiha direttament f'statement wieħed.
\_mingħajr `RETURNING`, ikollok bżonn `SELECT` separata biex taqbad l-ID ġenerat, u dan ifisser **round-trip extra** u **possibilità ta' race condition** (il-SELECT separata jista' ma jkunx affidabbli biex jirtrija l-row speċifiku tiegħek f'sennarji konkorrenti), così `RETURNING` hija kemm aktar effiċjent kemm aktar korretta.
\_Barra l-inserts, `RETURNING` jaħdem ma UPDATE (ara l-valuri ġodda wara update) u DELETE (aqbad dak li tnegħa — utli għal archiving, logging, jew konferma ta' tħassir).
\_Kombinata ma' CTEs, hija tippermetti patterns qawwija bħal qiegħed f'tabelli relatati billi tuża l-ID ritturnat f'statement wieħed.
\_Peress li jkun bżonn kostanti li taqbad valuri ġenerati (partikularment IDs) wara modifikazzjonijiet ta' data, u peress li `RETURNING` jipprovdi dan b'mod effiċjenti u atomiku (jevitaw queries extra u race conditions), il-fhim tal-clause `RETURNING` hija għarifa ta' PostgreSQL valwuża u li tintuża ta' spiss, li tagħmel il-kodiċi ta' modifikazzjoni ta' data aktar nadif, aktar effiċjenti u aktar korretta — konvenjenza prattika li tintuża rutinarjament f'applikazzjonijiet reali li jaħdmu ma' Postgres, partikolarment għall-bżonn ubikwu ta' jirtrija IDs ġenerati wara inserts.