RETURNING은 데이터를 바꾸는 문장이 SELECT처럼 행을 돌려주게 합니다. INSERT, UPDATE, DELETE, 또는 (PostgreSQL 17부터) MERGE 끝에 붙이고, 원하는 컬럼이나 식을 적습니다: INSERT INTO users (email) VALUES ('ada@example.com') RETURNING id;.
새 행 두 개가 PostgreSQL이 생성한 id와 기본값으로 채워진 plan과 함께 돌아옵니다. 두 번째 쿼리는 필요 없습니다.
삽입한 행의 id 가져오기
생성된 키를 받는 표준 방법은 RETURNING id입니다. 저장된 그대로의 행을 알려 주므로 identity 컬럼, serial, UUID 기본값, BEFORE 트리거가 넣은 값에도 동작합니다. 여러 행을 넣는 VALUES나 INSERT ... SELECT는 삽입된 행마다 한 행씩 돌려줍니다.
드라이버에서는 일반 쿼리 결과처럼 읽습니다. Python의 psycopg에서는 cursor.fetchone(), Node.js의 pg에서는 result.rows입니다. 탐색할 때는 RETURNING *도 괜찮지만, 애플리케이션 코드에서는 컬럼을 나열해 테이블이 바뀌어도 결과가 그대로 유지되게 하세요.
UPDATE가 바꾼 내용 확인하기
UPDATE에서 RETURNING은 변경 후의 행을 보여 주며, WHERE에 맞은 행만 돌려줍니다:
Book은 16.5, Lamp는 33으로 두 행이 돌아옵니다. Pen은 바뀌지 않았으므로 결과에 없습니다.
PostgreSQL 17에서 RETURNING은 새 값만 볼 수 있습니다. PostgreSQL 18에서는 old와 new가 추가됩니다(RETURNING old.price, new.price). 17에서는 테이블을 잠근 자기 자신의 복사본과 조인합니다:
각 행이 변경 전후의 가격과 함께 돌아옵니다. 10과 15, 20과 25입니다.
DELETE가 지운 행 돌려받기
DELETE ... RETURNING은 삭제한 행을 돌려줍니다. 로그를 남기거나, 되돌리거나, 워커가 작업을 지우면서 그 데이터를 받아 가는 작업 큐에 씁니다. WITH 쿼리 안에서는 돌려받은 행이 다음 문장으로 넘어가므로, 한 문장으로 행을 다른 테이블로 옮길 수 있습니다:
작업 1과 3이 tasks에서 빠져 done_tasks로 들어갑니다. 하나의 문장이므로 다른 세션이 두 테이블 모두에서, 또는 어느 쪽에서도 보이지 않는 상태를 볼 일은 없습니다.
MERGE가 어떤 동작을 했는지 확인하기
PostgreSQL 17부터 MERGE도 RETURNING을 받으며, merge_action() 함수가 행마다 INSERT, UPDATE, DELETE 중 하나를 돌려줍니다:
A-100은 7로 업데이트되고 C-300은 4로 삽입되었습니다. 동시 쓰기가 있는 상황에서 키 기준으로 삽입 또는 업데이트를 하려면 ON CONFLICT를 쓰는 upsert를 쓰세요. 이것도 RETURNING을 지원합니다.
RETURNING에 쓸 수 있는 것
SELECT 목록에 쓸 수 있는 것은 모두 됩니다. 컬럼, *, 식, 함수 호출, 별칭(RETURNING price * qty AS total)이 가능하고, 집계 함수만 안 됩니다. 돌려받은 행을 세거나 합하려면 문장을 WITH 쿼리로 감싸고 바깥 SELECT에서 집계하세요.
ON CONFLICT DO NOTHING으로 건너뛴 행이나, NULL을 반환한 BEFORE 트리거가 건너뛴 행은 돌려받지 않습니다.
자주 묻는 질문
PostgreSQL에서 방금 INSERT한 행의 id는 어떻게 가져오나요?
INSERT에 RETURNING id를 붙이세요. 같은 왕복 안에서 삽입된 모든 행의 생성된 값을 돌려주므로 SELECT max(id)보다 안전하고, identity 컬럼, serial, gen_random_uuid() 같은 기본값에도 동작합니다.
RETURNING이 별도의 SELECT보다 빠른가요?
대개 그렇습니다. 두 번째 문장과 서버와의 두 번째 왕복을 줄여 주고, 문장이 건드린 행만 정확히 돌려줍니다. 그 사이에 다른 세션이 행을 바꿀 틈도 없습니다.
MySQL도 RETURNING을 지원하나요?
MySQL에는 RETURNING 절이 없어서 INSERT 뒤에 LAST_INSERT_ID()를 읽어야 합니다. SQLite는 3.35 버전부터 RETURNING을 지원합니다.