Τι κάνει το RETURNING clause;

Question

Accepted Answer

Το **`RETURNING`** clause επιτρέπει στις εντολές `INSERT`, `UPDATE`, και `DELETE` να **επιστρέφουν δεδομένα** για τις γραμμές που επηρέασαν — πιο συνηθέστερα το auto-generated ID μετά από ένα insert, αλλά και οποιεσδήποτε στήλες ή υπολογισμένες τιμές. Εξοικονομεί ένα ξεχωριστό query και είναι ένα βολικό χαρακτηριστικό του PostgreSQL.

## RETURNING μετά από INSERT (λήψη του generated ID)

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

Η πιο συνηθησμένη χρήση: μετά από ένα insert, συνήθως χρειάζεστε το **generated primary key** (για να χρησιμοποιήσετε σε σχετικά inserts ή να επιστρέψετε στον client). Το `RETURNING id` το δίνει πίσω απευθείας — χωρίς ανάγκη για ένα ξεχωριστό query.

## RETURNING με UPDATE και 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` λειτουργεί σε UPDATE (δείτε τις νέες τιμές) και DELETE (καταγράψτε τι αφαιρέθηκε — χρήσιμο για αρχειοθέτηση ή επιβεβαίωση).

## Γιατί είναι πολύτιμο: απόδοση και ατομικότητα

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

## Ένα συνδυασμένο πρότυπο: insert σε σχετικούς πίνακες

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

## Γιατί έχει σημασία

Το `RETURNING` clause είναι ένα βολικό, συχνά χρησιμοποιούμενο χαρακτηριστικό του PostgreSQL που είναι πολύτιμο για την απόδοση και την ορθότητα κατά την τροποποίηση δεδομένων.

Η πιο συνηθησμένη και σημαντική χρήση του είναι η λήψη του **auto-generated ID πίσω από ένα INSERT** — μια σχεδόν καθολική ανάγκη (σχεδόν πάντα θέλετε το νέο primary key μετά από ένα insert, για να το χρησιμοποιήσετε σε σχετικές λειτουργίες ή να το επιστρέψετε στην εφαρμογή), και το `RETURNING id` το παρέχει απευθείας σε μία δήλωση.

Χωρίς το `RETURNING`, θα χρειάζατε ένα ξεχωριστό `SELECT` για να λάβετε το generated ID, που σημαίνει ένα **επιπλέον round-trip** και μια πιθανή **race condition** (το ξεχωριστό SELECT ενδέχεται να μην ανακτήσει αξιόπιστα τη συγκεκριμένη γραμμή σας σε σενάρια ταυτοχρονίας), οπότε το `RETURNING` είναι ταυτόχρονα πιο αποδοτικό και πιο σωστό.

Πέρα από τα inserts, το `RETURNING` λειτουργεί με UPDATE (δείτε τις νέες τιμές μετά από ένα update) και DELETE (καταγράψτε τι αφαιρέθηκε — χρήσιμο για αρχειοθέτηση, logging, ή επιβεβαίωση διαγραφών).

Σε συνδυασμό με CTEs, ενεργοποιεί ισχυρά πρότυπα όπως το insert σε σχετικούς πίνακες χρησιμοποιώντας το returned ID σε μία μόνο δήλωση.

Επειδή η λήψη generated τιμών (ιδιαίτερα IDs) μετά από τροποποιήσεις δεδομένων είναι μια σταθερή ανάγκη, και επειδή το `RETURNING` το παρέχει αποδοτικά και ατομικά (αποφεύγοντας επιπλέον queries και race conditions), η κατανόηση του `RETURNING` clause είναι πολύτιμη, συχνά εφαρμοζόμενη γνώση του PostgreSQL που κάνει τον κώδικα τροποποίησης δεδομένων πιο καθαρό, πιο αποδοτικό και πιο σωστό — μια πρακτική βολικότητα που χρησιμοποιείται ρουτίνα σε πραγματικές εφαρμογές που λειτουργούν με Postgres, ιδιαίτερα για την πανταχοθεν παρούσα ανάγκη ανάκτησης generated IDs μετά από inserts.