본문 바로가기
FrostK
테마 색상
로그인

읽는 데 7분Cat

PostgreSQL 19의 WAIT, 성공했는데 주문이 안 보이는 이유

IT 데이터 개발원리
PostgreSQL 19의 WAIT, 성공했는데 주문이 안 보이는 이유

주문을 저장한 뒤 읽기 복제본에서 조회했는데 아무것도 안 나와요. PostgreSQL 19의 새 WAIT에 그 주문의 로그 위치를 넣어도, 무엇을 기다렸느냐에 따라 success와 0행이 함께 나올 수 있어요. 복제본에 로그가 저장되는 것과 그 로그의 변경이 조회에 반영되는 건 다른 단계거든요.

11월 19일 정식 출시된 PostgreSQL 19.0에서 작은 주문 테이블과 읽기 복제본을 만들었어요. 복제본의 변경 반영을 멈춘 뒤 같은 위치를 세 가지 방식으로 기다리자, 어떤 성공을 확인해야 하는지 드러났어요.

디스크에는 있고 테이블에는 없는 주문

PostgreSQL은 변경 사항을 WAL이라는 로그에 남겨요. 복제본은 그 로그를 받아 저장하고, 데이터에 적용해요. 로그 안의 위치를 가리키는 값이 LSN이에요. 이 값을 전달하면 복제본이 내 쓰기까지 따라왔는지 기다릴 수 있어요.

시험에서는 복제본에서 pg_wal_replay_pause()로 반영을 멈추고, 주 서버에 주문 한 건을 넣었어요. INSERT는 자동 커밋으로 끝낸 뒤 pg_current_wal_insert_lsn()을 호출했어요. 나온 위치는 0/030051A8이었어요. 독자가 실행하면 위치 값은 달라져요.

-- 주 서버, 기본 자동 커밋 모드
INSERT INTO orders VALUES (1, 'paid');
SELECT pg_current_wal_insert_lsn();

복제본에서 그 위치의 로그가 디스크에 기록되기를 기다렸어요.

WAIT FOR LSN '0/030051A8'
  WITH (MODE 'standby_flush', TIMEOUT '5s', NO_THROW);
-- success

SELECT * FROM orders;
-- (0 rows)

로그는 도착했지만 반영을 멈춰 놨으니 주문은 아직 안 보여요. 같은 위치를 기본 모드인 standby_replay, 즉 데이터 반영 기준으로 기다리면 100ms 뒤 timeout이 나왔어요. 반영을 재개하고 다시 기다리자 success가 나왔고, 조회에도 1 | paid가 나타났어요.

복제본 상태와 기다린 단계 WAIT 결과 주문 조회
반영 중지, standby_flush success 0행
반영 중지, standby_replay, 100ms timeout 반영 대기 실패
반영 재개, standby_replay, 5s success 1 / paid

저장 직후 같은 데이터를 읽으려면 standby_replay의 성공이 필요해요. standby_write와 standby_flush는 로그 수신·저장 단계에 관한 조건이에요.

먼저 커밋하고, 먼저 기다려요

Simon Willison의 소개는 주 서버의 로그 위치를 복제본에 넘기는 짧은 예제를 보여줘요. 실제 앱에 붙일 때는 그 위치를 얻는 시점과 복제본에서 실행하는 순서까지 정해야 해요.

쓰기 커밋 후 LSN을 얻어 전달하고, 복제본에서 replay 성공을 확인한 다음 조회하는 네 단계
로그 저장이 아니라 데이터 반영을 기다리는 흐름이에요.

명시적으로 BEGIN을 쓴다면 UPDATE 직후가 아니라 COMMIT 뒤에 위치를 얻어야 해요. 공식 문서는 관련 쓰기 트랜잭션의 커밋 기록 끝 이상인 LSN을 요구해요. 커밋 이전 위치를 넘기면 기다린 위치와 읽어야 할 변경의 끝이 어긋날 수 있어요.

복제본에서는 테이블을 먼저 읽지 말고 WAIT부터 실행해요. 이번 시험에서 BEGIN; SELECT * FROM orders; 다음에 아직 도달하지 않은 위치를 기다렸더니, NO_THROW를 붙여도 cannot wait for a standby LSN while holding locks 오류가 났어요. 먼저 잡은 테이블 락 때문에 복제 반영이 나를 기다리고, 나는 복제 반영을 기다리는 상황을 막는 제한이에요.

격리 수준이 REPEATABLE READ여도 첫 조회 전에는 가능했어요. BEGIN ISOLATION LEVEL REPEATABLE READ 바로 뒤의 WAIT는 정상적으로 기다리다가 timeout을 반환했어요. 반면 먼저 SELECT 1을 실행하면, 트랜잭션이 스냅샷을 잡고 있다는 오류가 났어요. 스냅샷은 그 트랜잭션이 볼 데이터 상태의 기준이에요.

8월 베타 해설은 높은 격리 수준에서 사용할 수 없다고 설명했어요. 정식판 문서와 이번 결과에서는 첫 스냅샷을 잡기 전까지 WAIT를 실행할 수 있었어요. 오래된 예제를 적용할 때 확인할 차이예요.

오류를 안 던져도 결과는 확인해야 해요

NO_THROW는 실패를 성공으로 바꾸지 않아요. 예상 가능한 대기 실패를 앱이 상태 값으로 처리하도록 해 줘요.

반환 상태 앱에서 판단할 일
success 선택한 모드의 목표 위치에 도달했어요
timeout 목표 도달을 확인하지 못했어요. 재시도하거나 다른 읽기 경로를 선택해요
not in recovery 주 서버에서 실행했거나 대기 중 복제본이 승격됐을 수 있어요. 대상 서버와 LSN의 유효성을 다시 판단해요

시험에서 기본 standby 모드 명령을 주 서버에 보내면 not in recovery가 나왔어요. 잘못된 LSN 문자열을 넣으면 일반 오류가 났고요. NO_THROW가 모든 오류를 숨기지는 않아요.

💡
앱의 대기 시간은 양수로 명시하고 반환 상태를 검사하세요. TIMEOUT을 생략하거나 0으로 두면 무한 대기예요. 공식 문서상 0.5ms 이하도 0으로 반올림돼요.

장애로 주 서버가 바뀌는 경우에는 조건이 하나 더 있어요. WAIT는 LSN의 숫자만 비교해요. 서로 다른 복제 이력을 가리키는 타임라인까지 확인하지 않으므로, 장애 전환 뒤에는 앱이 넘긴 위치가 기대한 이력의 것인지 별도로 판단해야 해요.

확인한 범위

  • 기준일: 2026-11-20
  • 직접 한 것: Linux, PostgreSQL 19.0에서 주 서버와 물리 복제본을 만들고 반영을 중지했어요. 같은 LSN의 flush 성공·replay timeout·재개 후 조회를 비교하고, 락 보유와 REPEATABLE READ의 첫 조회 전후, 잘못된 LSN과 주 서버 실행을 대조했어요.
  • 읽은 것: 정식 출시 공지, 공식 WAIT 문서, Simon Willison의 소개, 8월 베타 해설.
  • 확인하지 못한 것: 실제 앱·연결 풀 통합, 장애 전환과 복구 충돌, 부하 상태의 지연·처리량은 시험하지 않았어요. 타임라인과 짧은 시간 반올림 조건은 문서로 확인했어요.

출처

PostgreSQL 19 Released
Most years PostgreSQL ships a new release in September, but this year's release came two months later thanks mainly to the flurry of issues that the PostgreSQL team needed to …
WAIT
wait for WAL to reach a target LSN Synopsis WAIT FOR LSN 'lsn' [ WITH ( option …

PostgreSQL 19 출시 공지, 8월 베타 해설