> ## Content Index
> Fetch the complete content index at: https://blog.frostk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# PostgreSQL 19의 WAIT, 성공했는데 주문이 안 보이는 이유
- URL: https://blog.frostk.com/postgres-wait-read-order/
- Published: 2026-11-20T01:00:00.000Z
- Updated: 2026-11-20T01:00:00.000Z
- Description: PostgreSQL 19의 새 WAIT 명령에 같은 주문의 로그 위치를 넣었어요. 복제본의 디스크 기록을 기다리면 success인데 조회는 0행, 데이터 반영을 기다리면 timeout이 나왔어요. 직접 만든 복제 지연에서 읽기 보장과 명령 순서를 나눠 확인했어요.
- Author: Cat
- Tags: IT, 데이터, 개발원리

주문을 저장한 뒤 읽기 복제본에서 조회했는데 아무것도 안 나와요. 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`이었어요. 독자가 실행하면 위치 값은 달라져요.

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

```

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

```sql
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의 소개](https://simonwillison.net/2026/Nov/19/postgresql-19/?ref=blog.frostk.com)는 주 서버의 로그 위치를 복제본에 넘기는 짧은 예제를 보여줘요. 실제 앱에 붙일 때는 그 위치를 얻는 시점과 복제본에서 실행하는 순서까지 정해야 해요.

![쓰기 커밋 후 LSN을 얻어 전달하고, 복제본에서 replay 성공을 확인한 다음 조회하는 네 단계](https://blog.frostk.com/content/images/2026/11/hf-56691719.png)

로그 저장이 아니라 데이터 반영을 기다리는 흐름이에요.

명시적으로 `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월 베타 해설](https://clickhouse.com/ko/blog/postgresql-19-wait-for-read-your-writes?ref=blog.frostk.com)은 높은 격리 수준에서 사용할 수 없다고 설명했어요. 정식판 문서와 이번 결과에서는 첫 스냅샷을 잡기 전까지 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 ReleasedMost 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 …![](https://blog.frostk.com/content/images/icon/favicon-1a39ac90-1223-4485-8349-2e0ba7f30933.ico)Simon WillisonSimon Willison’s Weblog](https://simonwillison.net/2026/Nov/19/postgresql-19/?ref=blog.frostk.com)

[WAITwait for WAL to reach a target LSN Synopsis WAIT FOR LSN 'lsn' \[ WITH ( option …![](https://blog.frostk.com/content/images/icon/favicon-09d85ab3-c544-4250-89b4-4ee4e6136948.ico)PostgreSQL Documentation![](https://blog.frostk.com/content/images/thumbnail/elephant-58b3e3b3-a891-491d-8b27-6b381e896809.png)](https://www.postgresql.org/docs/19/sql-wait.html?ref=blog.frostk.com)

[PostgreSQL 19 출시 공지](https://www.postgresql.org/about/news/postgresql-19-released-3449/?ref=blog.frostk.com), [8월 베타 해설](https://clickhouse.com/ko/blog/postgresql-19-wait-for-read-your-writes?ref=blog.frostk.com)