Cad é UPSERT (INSERT ON CONFLICT)?

Question

Accepted Answer

**UPSERT** ciallaíonn sé "cuir isteach, nó nuashonraigh má bhíonn sé ann cheana féin." Cuirtear an fheidhm seo i bhfeidhm ag PostgreSQL le **`INSERT ... ON CONFLICT`** — cuir isteach sraith, ach má bhriseadh sé srian uathúil, déan nuashonrú ar an sraith atá ann cheana (nó ná déan tada). Láimhdeálann sé an ngá coitianta "cuir isteach-nó-nuashonraigh" go geal.

## An fhadhb a réitíonn 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 — cuir isteach nó nuashonraigh

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

Dá mbeadh conflict ar an `email` srian uathúil agus tú ag iarraidh cuir isteach, déanann Postgres nuashonrú ar an sraith atá ann cheana. **`EXCLUDED`** tagraíonn sé do na luachanna a rinne tú iarracht a chur isteach, agus is féidir leat an tsraith atá ann (`users.login_count`) a thagartha freisin — rud a bhíonn ábalta duit loighic a dhéanamh cosúil le cuntar a mhéadú.

## ON CONFLICT DO NOTHING — cuir isteach nó fág scíth

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

Fágann `DO NOTHING` sraitheanna conflict ar leataoibh go ciúin — úsáideach do "cuir isteach mura bhfuil sé ann" gan earráidí.

## Úsáid choitianta: cuntair agus cuir isteach neamhspleách

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

## Cén fáth a bhíonn tábhacht leis

Is gné thábhachtach, phraiticiúil-luachmhar PostgreSQL a bhíonn in UPSERT (`INSERT ... ON CONFLICT`) a réitíonn an ngá an-choitianta "cuir isteach-nó-nuashonraigh" go geal agus go **sábháilte**, mar sin tá sé úsáideach a thuiscint do thúsachtaí sonraí i bhfíor-shaol.

An ngá — sraith a chur isteach agus a bheith ann cheana féin aici (de réir eochair uathúil) — tagann sé i láthair i gcónaí (upsert taifead, cuntair, cuir isteach neamhspleách, sonraí a shioncronú), agus bíonn fadhbanna ann leis na bealaí naive: cuirtear INSERT simplí i gcion earráide má bhíonn an tsraith ann, agus bíonn **condition iomaíochta** sa bhealach check-then-insert (SELECT ansin INSERT-nó-UPDATE) (d'fhéadfadh idirbheart comhthreomhar eile cuir isteach idir do sheiceáil agus do INSERT, earráidí nó nuashonruithe a cailleadh a chruthú). Réitíonn `ON CONFLICT` seo **go geal i ráiteas amháin** — an condition iomaíochta a bhaint, arb é an tairbhe ceartúchán príobháideach do fheidhmchláir comhthreomhara.

Tuiscint ar an dá fhoirm — **`DO UPDATE`** (cuir isteach nó nuashonraigh, le `EXCLUDED` ag tagartha do na luachanna a rinne tú iarracht a chur isteach agus an cumas tagartha a dhéanamh ar an tsraith atá ann do loighic cosúil le cuntair a mhéadú) agus **`DO NOTHING`** (cuir isteach nó fág scíth go ciúin) — cumhdaítear na patrúin choitianta (upsert taifead, cuir isteach neamhspleách, cuntair/aicmithe a choinneáil).

Ó bhraistint cuir isteach-nó-nuashonraigh go tráthúil agus é a dhéanamh i gceart agus go sábháilte (go geal, gan condition iomaíochta) tá fíoch ann do thogtha na sonraí in fheidhmchláir comhthreomhara, tá tuiscint ar UPSERT — an rud a réitíonn sé, an buntáiste atomicity/race-condition, agus an DO UPDATE/DO NOTHING foirmeacha — luachmhar, fréamhaithe-úsáideach eolas PostgreSQL a sholáthraíonn réiteach geal, sábháilte ar ghá choitianta atá earráide-bhogtha ar shlí eile, agus é a dhéanamh ina gné phraiticiúil, thábhachtach le haghaidh fheidhmchláir i bhfíor-shaol.