Mệnh đề RETURNING cho phép các statement INSERT, UPDATE, và DELETE trả về dữ liệu về các row mà chúng tác động — phổ biến nhất là ID tự sinh sau một insert, nhưng cũng có thể là bất kỳ cột hay giá trị được tính nào. Nó tiết kiệm một query riêng và là một tính năng PostgreSQL tiện lợi.
-- lấy id tự sinh từ insert (không cần SELECT riêng)
INSERT INTO users (name, email) VALUES ('Ann', '[email protected]')
RETURNING id; -- trả về id mới
-- trả về nhiều cột hoặc tất cả
INSERT INTO users (name) VALUES ('Bob')
RETURNING id, name, created_at; -- bao gồm các giá trị do DB sinh
INSERT INTO users (name) VALUES ('Carol') RETURNING *; -- toàn bộ row
Ứng dụng phổ biến nhất: sau khi insert, bạn thường cần primary key được sinh ra (để dùng trong các insert liên quan hoặc trả về cho client). RETURNING id trả về nó trực tiếp — không cần một query riêng.
-- xem những gì đã được update
UPDATE products SET price = price * 1.1 WHERE category = 'books'
RETURNING id, name, price; -- các giá trị MỚI sau khi update
-- thu lại các row đã xóa (ví dụ để archive/logging)
DELETE FROM sessions WHERE expired = true
RETURNING id, user_id; -- những row nào đã bị xóa
RETURNING hoạt động với UPDATE (xem các giá trị mới) và DELETE (thu lại những gì đã bị xóa — hữu ích để archive hoặc xác nhận).
Không có RETURNING:
INSERT ...; rồi một SELECT riêng để lấy id → HAI round-trip, và một race tiềm ẩn
(SELECT có thể không lấy được đúng row CỦA BẠN một cách đáng tin cậy).
Với RETURNING:
một statement trả về dữ liệu bị tác động một cách atomic → ít round-trip hơn, không có race.
-- dùng một CTE với RETURNING để insert và dùng id trong cùng 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; -- dùng id trả về trực tiếp
Mệnh đề RETURNING là một tính năng PostgreSQL tiện lợi, được dùng thường xuyên, có giá trị về hiệu quả và tính đúng đắn khi sửa đổi dữ liệu.
Ứng dụng phổ biến và quan trọng nhất của nó là lấy ID tự sinh từ một INSERT — một nhu cầu gần như phổ quát (bạn hầu như luôn muốn primary key mới sau khi insert, để dùng trong các thao tác liên quan hoặc trả về cho ứng dụng), và RETURNING id cung cấp nó trực tiếp trong một statement.
Không có RETURNING, bạn sẽ cần một SELECT riêng để lấy ID được sinh ra, nghĩa là một round-trip thừa và một race condition tiềm ẩn (SELECT riêng có thể không lấy được đúng row cụ thể của bạn một cách đáng tin cậy trong các kịch bản đồng thời), nên RETURNING vừa hiệu quả hơn vừa đúng đắn hơn.
Ngoài insert, RETURNING hoạt động với UPDATE (xem các giá trị mới sau khi update) và DELETE (thu lại những gì đã bị xóa — hữu ích để archive, logging, hoặc xác nhận xóa).
Kết hợp với CTE, nó cho phép các pattern mạnh mẽ như insert vào các bảng liên quan dùng ID trả về trong một statement duy nhất.
Vì việc lấy các giá trị được sinh ra (đặc biệt là ID) sau khi sửa đổi dữ liệu là một nhu cầu liên tục, và vì RETURNING cung cấp điều này một cách hiệu quả và atomic (tránh các query thừa và race condition), nên hiểu mệnh đề RETURNING là kiến thức PostgreSQL có giá trị, được áp dụng thường xuyên, giúp code sửa đổi dữ liệu sạch hơn, hiệu quả hơn, và đúng đắn hơn — một tiện ích thực tiễn được dùng thường nhật trong các ứng dụng thực làm việc với Postgres, đặc biệt cho nhu cầu phổ biến là lấy ID được sinh ra sau insert.