Gülçin Yıldırım Jelínek：读己之写：PostgreSQL 19中的WAIT FOR
内容提要
PostgreSQL 19新增WAIT FOR命令，允许会话阻塞至WAL达到指定位置，实现异步副本的读己之写一致性，无需同步复制开销。该命令支持多种等待模式（如standby_replay、standby_flush）及超时、NO_THROW选项。因需无快照运行以避免自死锁，WAIT FOR必须作为顶层命令执行，不能用于函数或事务内。此功能保持异步复制，仅需保证一致性的读取等待副本追赶。
延伸解读
适用场景与成本权衡
WAIT FOR 主要面向需要读己之写一致性但又不想承担同步复制开销的场景。它让写入保持异步，仅在读取需要一致性时等待副本追赶，从而将成本从每次写入转移到特定读取。对于大多数应用，直接使用可能较少，但连接池或协议感知代理可捕获写入后的 LSN，并在路由到副本前注入 WAIT FOR，实现透明的一致性保证。
快照与自死锁的约束
WAIT FOR 必须作为顶层命令执行，不能在函数、事务内使用，原因是等待期间不能持有快照。若持有快照，可能阻塞 WAL 回放（如 vacuum 记录需要移除旧快照可见的行），导致回放停滞，而会话又在等待回放达到目标 LSN，形成自死锁。因此，WAIT FOR 设计为无快照的实用命令，类似 VACUUM 或 CHECKPOINT。
使用注意事项
WAIT FOR 比较 LSN 时不考虑时间线，因此在主备切换后，成功状态可能对应不同时间线的 WAL，需谨慎对待。此外，等待模式有四种：standby_replay（默认，回放后可见）、standby_flush（落盘但不可见）、standby_write（写入但可能仍在 OS 缓冲区）、primary_flush（主库落盘）。超时和 NO_THROW 选项可控制等待行为，超时默认报错，NO_THROW 则返回状态。
Q&A
PostgreSQL 19 中的 WAIT FOR 命令有什么作用？
WAIT FOR 命令允许会话阻塞，直到 WAL 达到指定位置，从而在异步复制中实现读己之写一致性，而无需同步复制的开销。
如何使用 WAIT FOR 命令？请给出一个简单的示例。
在写入后，从主库获取当前 WAL 位置（如使用 pg_current_wal_insert_lsn()），然后在备库上执行 WAIT FOR LSN '0/306EE20'; 等待备库重放到该位置，之后再进行读取。
WAIT FOR 支持哪些等待模式？它们分别代表什么？
支持四种模式：standby_replay（默认，等待备库重放）、standby_flush（等待备库刷盘）、standby_write（等待备库写入）、primary_flush（等待主库刷盘）。
WAIT FOR 命令的超时和错误处理选项有哪些？
可以使用 TIMEOUT 选项限制等待时间，默认超时后抛出错误；如果指定 NO_THROW，则超时后返回状态 'timeout' 而不是报错。
为什么 WAIT FOR 不能用于函数或事务内？
因为 WAIT FOR 需要在不持有快照的情况下运行，否则可能造成自死锁：会话持有的快照可能阻塞 WAL 重放，而 WAIT FOR 又在等待重放，导致互相等待。因此它必须作为顶层命令执行。
WAIT FOR 与 synchronous_commit = remote_apply 相比有什么优势？
WAIT FOR 保持异步复制，写入不等待备库，只有需要读己之写一致性的读取才会等待备库追上，从而避免了同步复制带来的写入延迟和依赖。
WAIT FOR 返回的状态有哪些？分别代表什么？
可能的状态有：success（等待成功）、timeout（超时）、not in recovery（在非备库上使用备库模式，或等待期间备库被提升）。
WAIT FOR 在 PostgreSQL 19 中是如何实现的？
WAIT FOR 是一个实用命令，在无快照的顶层执行，后端在闩锁上睡眠，启动进程在重放到达指定 LSN 时唤醒它。
