RETURNING clause INSERT, UPDATE, ਅਤੇ DELETE statements ਨੂੰ ਉਹਨਾਂ affected ਕੀਤੀਆਂ ਗਈਆਂ rows ਬਾਰੇ ਡੇਟਾ return ਕਰਨ ਦਿੰਦਾ ਹੈ — ਸਭ ਤੋਂ ਆਮ ਤੌਰ ਤੇ insert ਦੇ ਬਾਅਦ auto-generated ID, ਪਰ ਕੋਈ ਵੀ columns ਜਾਂ computed values ਵੀ। ਇਹ ਇੱਕ ਵੱਖ query ਨੂੰ ਬਚਾਉਂਦਾ ਹੈ ਅਤੇ ਇੱਕ ਸੁਵਿਧਾਜਨਕ PostgreSQL ਵਿਸ਼ੇਸ਼ਤਾ ਹੈ।
-- get the auto-generated id back from the insert (no separate SELECT needed)
INSERT INTO users (name, email) VALUES ('Ann', '[email protected]')
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 ਕਰਨ ਦੇ ਬਾਅਦ, ਤੁਹਾਨੂੰ ਆਮ ਤੌਰ ਤੇ generated primary key ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ (ਸਬੰਧਤ inserts ਵਿੱਚ ਵਰਤਣ ਲਈ ਜਾਂ client ਨੂੰ return ਕਰਨ ਲਈ)। RETURNING id ਇਸਨੂੰ ਸਿੱਧਾ ਵਾਪਸ ਦਿੰਦਾ ਹੈ — ਕੋਈ ਵੱਖ query ਦੀ ਲੋੜ ਨਹੀਂ।
-- 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 'ਤੇ ਕੰਮ ਕਰਦਾ ਹੈ (ਨਵੀਆਂ values ਦੇਖੋ) ਅਤੇ DELETE 'ਤੇ (ਜੋ ਹਟਾਇਆ ਗਿਆ ਸੀ ਉਸ ਨੂੰ capture ਕਰੋ — archiving ਜਾਂ confirm ਕਰਨ ਲਈ ਲਾਭਦਾਇਕ)।
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.
-- 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
RETURNING clause ਇੱਕ ਸੁਵਿਧਾਜਨਕ, ਅਕਸਰ ਵਰਤੀ ਜਾਣ ਵਾਲੀ PostgreSQL ਵਿਸ਼ੇਸ਼ਤਾ ਹੈ ਜੋ ਡੇਟਾ ਨੂੰ modify ਕਰਦੇ ਸਮੇਂ ਕਾਰਜਕੁਸ਼ਲਤਾ ਅਤੇ ਸ਼ੁੱਧਤਾ ਲਈ ਮੁੱਲਵਾਨ ਹੈ।
ਇਸਦੀ ਸਭ ਤੋਂ ਆਮ ਅਤੇ ਮਹੱਤਵਪੂਰਨ ਵਰਤੋਂ ਹੈ INSERT ਤੋਂ auto-generated ID ਵਾਪਸ ਪ੍ਰਾਪਤ ਕਰਨਾ — ਇੱਕ near-universal ਜ਼ਰੂਰਤ (ਤੁਸੀਂ insert ਕਰਨ ਤੋਂ ਬਾਅਦ ਲਗਭਗ ਹਮੇਸ਼ਾ ਨਿਆ primary key ਚਾਹੁੰਦੇ ਹੋ, ਸਬੰਧਤ operations ਵਿੱਚ ਵਰਤਣ ਜਾਂ application ਨੂੰ return ਕਰਨ ਲਈ), ਅਤੇ RETURNING id ਇਸਨੂੰ ਸਿੱਧਾ ਇੱਕ statement ਵਿੱਚ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ।
RETURNING ਤੋਂ ਬਿਨਾਂ, ਤੁਹਾਨੂੰ generated ID ਨੂੰ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਇੱਕ ਵੱਖ SELECT ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, ਜਿਸਦਾ ਮਤਲਬ ਹੈ ਇੱਕ extra round-trip ਅਤੇ ਇੱਕ ਸੰਭਾਵਿਤ race condition (ਵੱਖ SELECT ਵਿੱਚ concurrent scenarios ਵਿੱਚ ਤੁਹਾਡੀ ਖਾਸ row ਨੂੰ ਭਰੋਸੇ ਨਾਲ retrieve ਨਹੀਂ ਕਰ ਸਕਦਾ), ਇਸ ਲਈ RETURNING ਵਧੇਰੇ ਮੁਨਾਸਬ ਅਤੇ ਵਧੇਰੇ ਸਠੀਕ ਹੈ।
Inserts ਤੋਂ ਪਰੇ, RETURNING UPDATE (update ਦੇ ਬਾਅਦ ਨਵੀਆਂ values ਦੇਖ ਕੇ) ਅਤੇ DELETE ਨਾਲ (ਜੋ ਹਟਾਇਆ ਗਿਆ ਸੀ ਉਸ ਨੂੰ capture ਕਰ ਕੇ — archiving, logging, ਜਾਂ deletions ਦੀ confirm ਕਰਨ ਲਈ ਲਾਭਦਾਇਕ) ਕੰਮ ਕਰਦਾ ਹੈ।
CTEs ਦੇ ਨਾਲ ਮਿਲ ਕੇ, ਇਹ powerful patterns ਨੂੰ ਸ਼ਾਮਲ ਕਰਦਾ ਹੈ ਜਿਵੇਂ ਕਿ ਇੱਕ ਹੀ statement ਵਿੱਚ returned ID ਦੀ ਵਰਤੋਂ ਕਰ ਕੇ ਸਬੰਧਤ tables ਵਿੱਚ insert ਕਰਨਾ।
ਕਿਉਂਕਿ generated values (ਖਾਸ ਤੌਰ ਤੇ IDs) ਨੂੰ ਡੇਟਾ modifications ਤੋਂ ਬਾਅਦ ਪ੍ਰਾਪਤ ਕਰਨਾ ਇੱਕ ਨਿਰੰਤਰ ਜ਼ਰੂਰਤ ਹੈ, ਅਤੇ ਕਿਉਂਕਿ RETURNING ਇਸ ਨੂੰ ਮੁਨਾਸਬ ਤਰੀਕੇ ਨਾਲ ਅਤੇ atomically (extra queries ਅਤੇ race conditions ਨੂੰ ਰੋਕ ਕੇ) ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ, RETURNING clause ਨੂੰ ਸਮਝਣਾ ਮੁੱਲਵਾਨ, ਅਕਸਰ-ਲਾਗੂ ਕੀਤੀ ਜਾਣ ਵਾਲੀ PostgreSQL ਨਾਲੀਖਾ ਹੈ ਜੋ ਡੇਟਾ-modification ਕੋਡ ਨੂੰ ਸਾਫ਼ ਸੁਥਰਾ, ਵਧੇਰੇ ਮੁਨਾਸਬ, ਅਤੇ ਵਧੇਰੇ ਸਠੀਕ ਬਣਾਉਂਦੀ ਹੈ — ਇੱਕ ਵਿਹਾਰਕ ਸੁਵਿਧਾ ਜੋ Postgres ਨਾਲ ਕਾਰਜਰਤ real applications ਵਿੱਚ ਨਿਯਮਿਤ ਤੌਰ ਤੇ ਵਰਤੀ ਜਾਂਦੀ ਹੈ, ਵਿਸ਼ੇਸ ਤੌਰ ਤੇ inserts ਤੋਂ ਬਾਅਦ generated IDs ਨੂੰ retrieve ਕਰਨ ਦੀ ubiquitous ਜ਼ਰੂਰਤ ਲਈ।