X'inhu UPSERT (INSERT ON CONFLICT)?

Question

Accepted Answer

**UPSERT** ifisser "daħħal, jew aġġorna jekk diġà jeżisti." PostgreSQL jimplimenta dan b'**`INSERT ... ON CONFLICT`** — daħħal ringiela, imma jekk ikun jikser kostraint uniku, minflok iggorna l-ringiela eżistenti (jew ma tagħmilx xejn). Jiġġestixxi l-ħtieġa komuni ta' "daħħal-jew-aġġorna" b'mod atomiku.

## Il-problema li UPSERT issolvi

```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 — daħħal jew aġġorna

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

Jekk il-daħħal ikun ikun jikser il-kostraint uniku ta' `email`, Postgres aġġorna r-ringiela eżistenti minflok. **`EXCLUDED`** jirreferi għall-valuri li ppruvajt tadħħol, u tista' treferenza wkoll ir-ringiela eżistenti (`users.login_count`) — li tagħmel loġika bħal inkrementazzjoni ta' kontatur.

## ON CONFLICT DO NOTHING — daħħal jew aqbeż

```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` tisseq b'mod silenziuż ir-ringieli li jikkonfligaw — utli għal "daħħal jekk m'intix preżenti" mingħajr iżbalji.

## Use komuni: kontaturи u daħħlat idempotenti

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

## Għaliex hu importanti

UPSERT (`INSERT ... ON CONFLICT`) hija feature importanti u prattika ta' PostgreSQL li tissolvi l-ħtieġa komuni ta' "daħħal-jew-aġġorna" b'mod ċar u **sigur**, allura l-fehim tiegħu huwa utli għal operazzjonijiet tad-data f'dinja reali.

Il-ħtieġa — daħħal ringiela li tista' diġà teżisti (minn ċavetta unika) — issir qed tidhur kostantement (upserting rekords, kontaturи, daħħlat idempotenti, sinkronizzazzjoni ta' data), u l-alternattivi naiviċi huma problematiċi: INSERT sempliċi jifla b'iżball jekk ir-ringiela teżisti, u l-approċċ ta' check-imbagħad-insert (SELECT imbagħad INSERT-jew-UPDATE) għandu **race condition** (transazzjoni konkorrenti oħra tista' tadħħol bejn iċ-ċeck tiegħek u l-insert tiegħek, u tikkawża żbalji jew daħliet mitlufa). `ON CONFLICT` issolvi dan **b'mod atomiku f'statement wieħed** — telimina r-race condition, li hija l-benefiċċju tal-korrettezza prinċipali tiegħu għal applikazzjoniet konkorrenti.

L-għarfien ta' ż-żewġ forom — **`DO UPDATE`** (daħħal jew aġġorna, b'`EXCLUDED` li jirreferi għall-valuri ppruvati u l-ħila ta' referienzja rir-ringiela eżistenti għal loġika bħal inkrementazzjoni ta' kontatur) u **`DO NOTHING`** (daħħal jew aqbeż b'mod silenziuż) — ikopri l-mudelli komuni (upserting rekords, daħħlat idempotenti, sostentament ta' kontaturи/aggregati).

Billi insert-jew-aġġorna hija operazzjoni frekwenti u għamilha b'mod korrett u sigur (b'mod atomiku, mingħajr race conditions) huwa importanti għall-integrità tad-data f'applikazzjoniet konkorrenti, il-fehim ta' UPSERT — x'issolvi, il-benefiċċju tal-atomicity/race-condition, u l-forom DO UPDATE/DO NOTHING — huwa għarfien PostgreSQL valuwat, spiss-applikat li jipprovdi soluzzjoni ċara u sigura għal ħtieġa komuni li mod ieħor hija soġġetta għal iżbalji, u jagħmilha feature prattika u importanti għal applikazzjoniet reali.