Τι είναι το UPSERT (INSERT ON CONFLICT);

Question

Accepted Answer

**UPSERT** σημαίνει "εισαγωγή, ή ενημέρωση αν υπάρχει ήδη." Η PostgreSQL υλοποιεί αυτό με **`INSERT ... ON CONFLICT`** — εισάγει μια σειρά, αλλά αν θα παραβίαζε έναν περιορισμό μοναδικότητας, αντ' αυτού ενημερώνει την υπάρχουσα σειρά (ή δεν κάνει τίποτα). Χειρίζεται ατομικά την κοινή ανάγκη "εισαγωγή-ή-ενημέρωση".

## Το πρόβλημα που λύνει το UPSERT

```text
You want to insert a row, but it might already exist (by a unique key):
  ❌ a plain INSERT fails with a unique-violation error if it exists
  ❌ check-then-insert (SELECT, then INSERT or UPDATE) has a RACE CONDITION
     (another transaction could insert between your check and insert)
→ ON CONFLICT does it atomically in ONE statement (no race condition)
```

## ON CONFLICT DO UPDATE — εισαγωγή ή ενημέρωση

```sql
INSERT INTO users (email, name, login_count)
VALUES ('ann@x.com', 'Ann', 1)
ON CONFLICT (email)                  -- if a row with this email already exists...
DO UPDATE SET                        -- ...UPDATE it instead
  name = EXCLUDED.name,              -- EXCLUDED = the values you tried to insert
  login_count = users.login_count + 1;  -- can reference the existing row too
```

Αν η εισαγωγή θα συγκρουόταν στον περιορισμό μοναδικότητας `email`, η Postgres ενημερώνει την υπάρχουσα σειρά αντ' αυτού. **`EXCLUDED`** αναφέρεται στις τιμές που προσπαθήσατε να εισάγετε, και μπορείτε επίσης να αναφέρετε την υπάρχουσα σειρά (`users.login_count`) — ενεργοποιώντας λογική όπως η αύξηση ενός μετρητή.

## ON CONFLICT DO NOTHING — εισαγωγή ή παράλειψη

```sql
INSERT INTO users (email, name) VALUES ('ann@x.com', 'Ann')
ON CONFLICT (email) DO NOTHING;      -- if it exists, just skip (no error)
```

`DO NOTHING` αγνοεί σιωπηρά τις συγκρουόμενες σειρές — χρήσιμο για "εισαγωγή αν δεν υπάρχει" χωρίς σφάλματα.

## Μια κοινή πρακτική χρήση: μετρητές και ιδεμπότεντες εισαγωγές

```sql
-- track page views — insert on first view, increment on subsequent
INSERT INTO page_views (page_id, views) VALUES (5, 1)
ON CONFLICT (page_id) DO UPDATE SET views = page_views.views + 1;
```

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

Το UPSERT (`INSERT ... ON CONFLICT`) είναι ένα σημαντικό, πρακτικά αποδοτικό χαρακτηριστικό της PostgreSQL που λύνει την πολύ κοινή ανάγκη "εισαγωγή-ή-ενημέρωση" καθαρά και **ασφαλώς**, οπότε η κατανόησή του είναι χρήσιμη για πραγματικές λειτουργίες δεδομένων.

Η ανάγκη — εισαγωγή μιας σειράς που ενδέχεται να υπάρχει ήδη (με ένα μοναδικό κλειδί) — προκύπτει συνεχώς (εισαγωγή-ενημέρωση εγγραφών, μετρητές, ιδεμπότεντες εισαγωγές, συγχρονισμός δεδομένων), και οι αφελείς εναλλακτικές λύσεις έχουν προβλήματα: μια απλή INSERT αποτυγχάνει με σφάλμα αν η σειρά υπάρχει, και η προσέγγιση ελέγχου-και-εισαγωγής (SELECT και μετά INSERT-ή-UPDATE) έχει **κατάσταση race condition** (μια άλλη ταυτόχρονη συναλλαγή θα μπορούσε να εισάγει μεταξύ του ελέγχου και της εισαγωγής σας, προκαλώντας σφάλματα ή απώλεια ενημερώσεων). `ON CONFLICT` λύνει αυτό **ατομικά σε μια μόνο πρόταση** — εξαλείφοντας την κατάσταση race condition, η οποία είναι το κύριο όφελος ορθότητας του για ταυτόχρονες εφαρμογές.

Η κατανόηση και των δύο μορφών — **`DO UPDATE`** (εισαγωγή ή ενημέρωση, με `EXCLUDED` να αναφέρει τις προσπάθειες τιμών και την ικανότητα αναφοράς της υπάρχουσας σειράς για λογική όπως η αύξηση μετρητών) και **`DO NOTHING`** (εισαγωγή ή παράλειψη σιωπηρά) — καλύπτει τα κοινά μοτίβα (εισαγωγή-ενημέρωση εγγραφών, ιδεμπότεντες εισαγωγές, συντήρηση μετρητών/συγκεντρώσεων).

Επειδή η εισαγωγή-ή-ενημέρωση είναι μια συχνή λειτουργία και η ορθή και ασφαλής εκτέλεσή της (ατομικά, χωρίς κατάστασες race condition) έχει σημασία για την ακεραιότητα δεδομένων σε ταυτόχρονες εφαρμογές, η κατανόηση του UPSERT — τι λύνει, το όφελος ατομικότητας/race-condition, και οι μορφές DO UPDATE/DO NOTHING — είναι πολύτιμη, συχνά εφαρμοζόμενη γνώση της PostgreSQL που παρέχει μια καθαρή, ασφαλή λύση σε μια κοινή ανάγκη που είναι διαφορετικά επιρρεπής σε σφάλματα, κάνοντάς την ένα πρακτικό, σημαντικό χαρακτηριστικό για πραγματικές εφαρμογές.