UPSERT (INSERT ON CONFLICT) คืออะไร?

Question

Accepted Answer

**UPSERT** หมายถึง "insert หรือ update หากมีอยู่แล้ว" PostgreSQL ทำสิ่งนี้ด้วย **`INSERT ... ON CONFLICT`** — insert แถวหนึ่ง แต่ถ้ามันจะละเมิด unique constraint ก็จะ update แถวที่มีอยู่แทน (หรือไม่ทำอะไรเลย) มันจัดการความต้องการ "insert หรือ update" ที่พบบ่อยได้อย่าง atomic

## ปัญหาที่ 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 — insert หรือ 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
```

หากการ insert จะเกิด conflict กับ unique constraint ของ `email` Postgres จะ update แถวที่มีอยู่แทน **`EXCLUDED`** อ้างถึงค่าที่คุณพยายาม insert และคุณสามารถอ้างถึงแถวที่มีอยู่ (`users.login_count`) ได้ด้วย ซึ่งช่วยให้ทำตรรกะอย่างการเพิ่มค่าตัวนับได้

## ON CONFLICT DO NOTHING — insert หรือข้าม

```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` ข้ามแถวที่ conflict อย่างเงียบ ๆ มีประโยชน์สำหรับ "insert ถ้ายังไม่มี" โดยไม่มี error

## การใช้งานจริงที่พบบ่อย: ตัวนับและ insert แบบ idempotent

```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 หรือ update" ที่พบบ่อยมากได้อย่างสะอาดและ **ปลอดภัย** ดังนั้นการเข้าใจมันจึงมีประโยชน์สำหรับการดำเนินงานกับข้อมูลในโลกจริง

ความต้องการ — การ insert แถวที่อาจมีอยู่แล้ว (ตาม unique key) — เกิดขึ้นตลอด (upsert ระเบียน, ตัวนับ, insert แบบ idempotent, การ sync ข้อมูล) และทางเลือกแบบไร้เดียงสามีปัญหา: INSERT ธรรมดาล้มเหลวด้วย error หากแถวมีอยู่ และวิธี check-then-insert (SELECT แล้ว INSERT-หรือ-UPDATE) มี **race condition** (transaction อื่นที่ทำงานพร้อมกันอาจ insert ระหว่างการตรวจสอบและการ insert ของคุณ ทำให้เกิด error หรือ update ที่หายไป) `ON CONFLICT` แก้สิ่งนี้อย่าง **atomic ในคำสั่งเดียว** ขจัด race condition ซึ่งเป็นประโยชน์หลักด้านความถูกต้องสำหรับแอปพลิเคชันที่ทำงานพร้อมกัน

การเข้าใจทั้งสองรูปแบบ — **`DO UPDATE`** (insert หรือ update โดย `EXCLUDED` อ้างถึงค่าที่พยายาม insert และความสามารถในการอ้างถึงแถวที่มีอยู่สำหรับตรรกะอย่างการเพิ่มค่าตัวนับ) และ **`DO NOTHING`** (insert หรือข้ามอย่างเงียบ ๆ) — ครอบคลุมรูปแบบที่พบบ่อย (upsert ระเบียน, insert แบบ idempotent, การดูแลตัวนับ/aggregate)

เนื่องจาก insert-หรือ-update เป็นการดำเนินงานที่เกิดบ่อยและการทำให้ถูกต้องและปลอดภัย (atomic โดยไม่มี race condition) มีความสำคัญต่อความถูกต้องของข้อมูลในแอปพลิเคชันที่ทำงานพร้อมกัน การเข้าใจ UPSERT — สิ่งที่มันแก้, ประโยชน์ด้าน atomicity/race-condition และรูปแบบ DO UPDATE/DO NOTHING — จึงเป็นความรู้ PostgreSQL ที่มีคุณค่าและถูกนำไปใช้บ่อย ที่ให้ทางออกที่สะอาดและปลอดภัยสำหรับความต้องการที่พบบ่อยซึ่งมิฉะนั้นจะเกิดข้อผิดพลาดง่าย ทำให้มันเป็นความสามารถที่ใช้งานได้จริงและสำคัญสำหรับแอปพลิเคชันจริง