clause RETURNING ทำอะไร?

Question

Accepted Answer

clause **`RETURNING`** ช่วยให้คำสั่ง `INSERT`, `UPDATE` และ `DELETE` **คืนข้อมูล** เกี่ยวกับแถวที่มันส่งผลกระทบได้ ที่พบบ่อยที่สุดคือ ID ที่สร้างอัตโนมัติหลังการ insert แต่ก็รวมถึงคอลัมน์ใด ๆ หรือค่าที่คำนวณได้ด้วย มันช่วยประหยัด query แยกอีกหนึ่งครั้งและเป็นความสามารถที่สะดวกของ PostgreSQL

## RETURNING หลัง INSERT (ได้ 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 คุณมักต้องการ **primary key ที่สร้างขึ้น** (เพื่อใช้ในการ insert ที่เกี่ยวข้องหรือส่งกลับให้ 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 (จับสิ่งที่ถูกลบ มีประโยชน์สำหรับการ archive หรือการยืนยัน)

## ทำไมจึงมีคุณค่า: ประสิทธิภาพและ atomicity

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

## ทำไมจึงสำคัญ

clause `RETURNING` เป็นความสามารถที่สะดวกและใช้บ่อยของ PostgreSQL ที่มีคุณค่าต่อประสิทธิภาพและความถูกต้องเมื่อมีการแก้ไขข้อมูล

การใช้งานที่พบบ่อยและสำคัญที่สุดคือการได้ **ID ที่สร้างอัตโนมัติกลับมาจาก INSERT** ซึ่งเป็นความต้องการที่แทบเป็นสากล (คุณเกือบจะต้องการ primary key ใหม่หลังการ insert เสมอ เพื่อใช้ในการดำเนินงานที่เกี่ยวข้องหรือส่งกลับให้แอปพลิเคชัน) และ `RETURNING id` ให้มันโดยตรงในคำสั่งเดียว

หากไม่มี `RETURNING` คุณจะต้องมี `SELECT` แยกเพื่อได้ ID ที่สร้างขึ้น ซึ่งหมายถึง **round-trip เพิ่ม** และ **race condition** ที่อาจเกิดขึ้น (SELECT แยกอาจดึงแถวที่เจาะจงของคุณไม่ได้อย่างน่าเชื่อถือในสถานการณ์ที่ทำงานพร้อมกัน) ดังนั้น `RETURNING` จึงทั้งมีประสิทธิภาพกว่าและถูกต้องกว่า

นอกเหนือจาก insert แล้ว `RETURNING` ทำงานกับ UPDATE (เห็นค่าใหม่หลังการ update) และ DELETE (จับสิ่งที่ถูกลบ มีประโยชน์สำหรับการ archive, logging หรือการยืนยันการลบ)

เมื่อรวมกับ CTEs มันเปิดใช้รูปแบบที่ทรงพลังอย่างการ insert เข้าตารางที่เกี่ยวข้องโดยใช้ ID ที่คืนมาในคำสั่งเดียว

เนื่องจากการได้ค่าที่สร้างขึ้น (โดยเฉพาะ ID) หลังการแก้ไขข้อมูลเป็นความต้องการที่เกิดตลอด และเนื่องจาก `RETURNING` ให้สิ่งนี้อย่างมีประสิทธิภาพและ atomic (หลีกเลี่ยง query เพิ่มและ race condition) การเข้าใจ clause `RETURNING` จึงเป็นความรู้ PostgreSQL ที่มีคุณค่าและถูกนำไปใช้บ่อยซึ่งทำให้โค้ดแก้ไขข้อมูลสะอาดขึ้น มีประสิทธิภาพมากขึ้น และถูกต้องมากขึ้น เป็นความสะดวกที่ใช้งานได้จริงซึ่งใช้เป็นประจำในแอปพลิเคชันจริงที่ทำงานกับ Postgres โดยเฉพาะสำหรับความต้องการที่พบทั่วไปในการดึง ID ที่สร้างขึ้นหลังการ insert