RETURNING khiến một câu lệnh thay đổi dữ liệu trả về các hàng, giống như SELECT. Thêm nó vào cuối một lệnh INSERT, UPDATE, DELETE hoặc (từ PostgreSQL 17) MERGE, theo sau là các cột hay biểu thức bạn muốn: INSERT INTO users (email) VALUES ('ada@example.com') RETURNING id;.
Cả hai hàng mới đều trả về kèm id mà PostgreSQL đã sinh và plan được điền theo giá trị mặc định, không cần truy vấn thứ hai.
Lấy id của hàng vừa chèn
RETURNING id là cách chuẩn để lấy khóa được sinh. Nó báo lại hàng đúng như đã được lưu, nên chạy được với cột identity, serial, giá trị mặc định UUID và giá trị do trigger BEFORE đặt. Một VALUES nhiều hàng hoặc INSERT ... SELECT trả về một hàng cho mỗi hàng được chèn.
Driver đọc nó như mọi kết quả truy vấn khác: cursor.fetchone() trong Python với psycopg, result.rows trong Node.js với pg. RETURNING * thì ổn khi đang thử nghiệm; trong code ứng dụng, hãy liệt kê các cột để kết quả giữ ổn định khi bảng thay đổi.
Xem một lệnh UPDATE đã đổi gì
Với UPDATE, RETURNING cho thấy các hàng sau khi thay đổi, và chỉ những hàng khớp với WHERE:
Hai hàng được trả về: Book với giá 16,5 và Lamp với giá 33. Pen không bị đụng tới, nên không có trong kết quả.
Trong PostgreSQL 17, RETURNING chỉ thấy giá trị mới. PostgreSQL 18 thêm old và new (RETURNING old.price, new.price). Trên bản 17, hãy join bảng với một bản sao đã lock của chính nó:
Mỗi hàng trả về kèm giá trước và sau: 10 và 15, 20 và 25.
Trả về các hàng mà DELETE đã xóa
DELETE ... RETURNING trả cho bạn những hàng nó đã xóa, để ghi log, để hoàn tác, hoặc cho một hàng đợi công việc nơi worker xóa một job và lấy lại dữ liệu của nó. Bên trong một truy vấn WITH, các hàng được trả về sẽ đi vào câu lệnh tiếp theo, giúp chuyển hàng giữa các bảng chỉ trong một câu lệnh:
Task 1 và 3 rời khỏi tasks và có mặt trong done_tasks. Đây là một câu lệnh duy nhất, nên không phiên nào khác thấy chúng ở cả hai bảng hay không ở bảng nào.
Biết MERGE đã thực hiện hành động nào
Từ PostgreSQL 17, MERGE chấp nhận RETURNING, và hàm merge_action() trả về INSERT, UPDATE hoặc DELETE cho mỗi hàng:
A-100 được cập nhật thành 7 và C-300 được chèn với 4. Để chèn hoặc cập nhật theo khóa khi có ghi đồng thời, hãy ưu tiên upsert với ON CONFLICT, cách này cũng hỗ trợ RETURNING.
RETURNING có thể chứa gì
Mọi thứ một danh sách SELECT có thể chứa: cột, *, biểu thức, lời gọi hàm và bí danh (RETURNING price * qty AS total), trừ hàm tổng hợp. Để đếm hoặc cộng các hàng được trả về, hãy bọc câu lệnh trong một truy vấn WITH rồi tổng hợp ở SELECT bên ngoài.
Những hàng bị bỏ qua bởi ON CONFLICT DO NOTHING, hoặc bởi một trigger BEFORE trả về NULL, sẽ không được trả về.
Câu hỏi thường gặp
Làm sao lấy id của hàng vừa chèn trong PostgreSQL?
Thêm RETURNING id vào lệnh INSERT. Nó trả về giá trị được sinh cho mỗi hàng được chèn ngay trong cùng một lần gọi, an toàn hơn SELECT max(id) và chạy được với cột identity, serial và giá trị mặc định như gen_random_uuid().
RETURNING có nhanh hơn một lệnh SELECT riêng không?
Thường là có. Nó bớt được một câu lệnh và một lần gọi tới máy chủ, và trả về đúng những hàng mà câu lệnh đã tác động, không để kẽ hở nào cho phiên khác thay đổi chúng ở giữa.
MySQL có hỗ trợ RETURNING không?
MySQL không có mệnh đề RETURNING; thay vào đó bạn đọc LAST_INSERT_ID() sau khi chèn. SQLite hỗ trợ RETURNING từ phiên bản 3.35.