Dev & EngARTIGO

PostgreSQL 19 chega com WAIT FOR LSN para resolver o problema das réplicas desatualizadas

PostgreSQL 19 chega com WAIT FOR LSN para resolver o problema das réplicas desatualizadas
Imagem gerada por IA
Artigo · Dev & Eng
Leitura
5 min
Código
2
Fontes
1
Em resumo

Lançado em novembro de 2026 após dois meses de atraso por uma onda de vulnerabilidades reportadas com ajuda de IA, o PostgreSQL 19 traz o comando WAIT FOR LSN, que permite a uma aplicação garantir que acabou de ler, numa réplica, o dado que ela mesma escreveu no banco principal.

O PostgreSQL↳PostgreSQL11 conteúdosPostgreSQL via SSL com GolangData · abr 20195 itens legais sobre data types do PostgreSQLData · mar 20195 serviços gratuitos na cloud para bancos de dados PostgresData · fev 2025Ver tudo em Data → 19 foi lançado em 19 de novembro de 2026, segundo relato de Simon Willison em seu blog. É um lançamento fora do calendário habitual: o projeto costuma entregar a versão anual em setembro, mas desta vez o time precisou lidar com uma enxurrada de relatos de vulnerabilidade gerados com apoio de ferramentas de IA, o que empurrou o release em dois meses.

Esse detalhe não é rodapé. Projetos open source↳Open source71 conteúdosComo o Open Source Está Liberando o Poder da Automação para TodosDev (Back & Front) · out 2025Código aberto: programadores criam software da NASA sem saberDev (Back & Front) · abr 2021N8N: O que é a ferramenta open source que está revolucionando a automação em TI?Dev (Back & Front) · dez 2025Ver tudo em Dev (Back & Front) → de infraestrutura crítica têm enfrentado um volume crescente de disclosures automatizados, muitos de baixa qualidade, que consomem tempo de triagem da equipe de segurança antes de qualquer trabalho em feature nova poder avançar. Para quem mantém banco de dados em produção, é um lembrete de que o ciclo de release de ferramentas que você depende também é afetado por esse ruído.

O problema que read-your-writes resolve

A novidade mais relevante da versão, na leitura de Willison, mira direto em quem distribui leitura entre réplicas (standbys) e escrita no banco principal. É um padrão comum em arquiteturas que escalam leitura horizontalmente: a aplicação escreve no primary e manda a maior parte das consultas para uma ou mais réplicas, aliviando a carga do nó principal.

O problema é a replicação assíncrona. Entre o UPDATE no primary e o momento em que a réplica replica esse write-ahead log (WAL), existe uma janela de atraso. Se o próprio usuário que acabou de salvar um dado faz, na sequência, uma leitura que cai numa réplica atrasada, ele vê a versão antiga: edita um perfil e, ao recarregar a página, o campo volta ao valor anterior. É um bug de experiência clássico em sistemas com read replicas.

Como o WAIT FOR LSN funciona

O PostgreSQL 19 ataca isso com o comando WAIT FOR LSN, que faz uma sessão na réplica esperar até que o WAL tenha sido replayado até um ponto específico, identificado por um LSN (log sequence number), antes de rodar a consulta seguinte. Na prática, o fluxo descrito por Willison funciona assim no primary, logo após a escrita:

O trecho do artigo de Simon Willison mostra o comando WAIT FOR LSN com o valor do log sequence number e a cláusula TIMEOUT de 0.1 segundo
O trecho do artigo de Simon Willison mostra o comando WAIT FOR LSN com o valor do log sequence number e a cláusula TIMEOUT de 0.1 segundo. Reprodução: simonwillison.net.
sql
UPDATE movie SET genre = 'Dramatic' WHERE genre = 'Drama';
SELECT pg_current_wal_insert_lsn();

A função pg_current_wal_insert_lsn() retorna um valor como 0/0306EE20. A aplicação guarda esse valor (um cookie assinado é a sugestão de Willison) e, na requisição seguinte, antes de consultar a réplica, manda:

Simon Willison

Para aplicações que enviam leituras para standbys, PostgreSQL 19 adiciona consistência de "leia o que você escreveu" com o novo comando WAIT FOR LSN.

No original: For applications that send reads to standbys, PostgreSQL 19 adds "read-your-writes" consistency with the new WAIT FOR LSN command.

Fonte: Simon Willison
sql
WAIT FOR LSN '0/0306EE20' WITH (TIMEOUT '0.1s');
SELECT * FROM movie WHERE genre = 'Drama';

O TIMEOUT é opcional, mas é a parte que importa para quem roda isso em produção: sem ele, uma réplica anormalmente atrasada trava a sessão indefinidamente. Com ele, a aplicação recebe um erro se a réplica não alcançar o LSN pedido dentro do prazo, e pode decidir o que fazer: tentar de novo, cair para o primary, ou simplesmente mostrar um aviso de dado ainda em sincronização.

Um padrão que a Wikipedia já resolvia na unha

Willison nota que esse padrão não é inédito: ele o encontrou primeiro no MediaWiki, o software por trás da Wikipedia, que roda sobre MySQL e implementa a mesma ideia de forma manual. O MediaWiki salva a posição do binlog primário na sessão do usuário e, no início de cada requisição, espera a réplica alcançar aquela posição antes de fazer qualquer leitura nela.

O código do MediaWiki hoje usa a função WAIT_FOR_EXECUTED_GTID_SET() do MySQL, com fallback para SOURCE_POS_WAIT() em configurações mais antigas. Em outras palavras: times que precisavam dessa garantia vinham reimplementando, cada um à sua maneira, um mecanismo que agora o PostgreSQL oferece como comando nativo. Isso reduz código de infraestrutura que cada aplicação tinha que manter e testar por conta própria.

Quando isso muda sua arquitetura (e quando não muda)

A diferença entre a solução nativa e a gambiarra caseira é relevante para quem decide sua stack de dados. Antes do PostgreSQL 19, garantir read-your-writes em réplica exigia uma de três saídas: forçar a leitura pós-escrita sempre no primary (perdendo o benefício de escalar leitura), implementar um sistema próprio de rastreamento de LSN na aplicação, ou aceitar a inconsistência eventual e absorver o custo em UX↳UX33 conteúdosUX e IA: Transformando Experiências Digitais com Inteligência ArtificialProduto & UX · jan 2025UX, IA e Front-End: quando experiência, inteligência e código se encontram para criar o futuro digitalProduto & UX · jul 2025Novidades em UX/UI para 2025: O futuro do design de experiências digitaisProduto & UX · abr 2025Ver tudo em Produto & UX →.

Em resumo: o WAIT FOR LSN move essa lógica para dentro do banco, com uma API de poucas linhas, timeout configurável e sem precisar de código de aplicação replicando o que o MySQL exigia reimplementar.

Não é algo que toda aplicação precisa. Se seu sistema não usa réplicas de leitura, ou se a janela de replication lag é irrelevante para o caso de uso (um dashboard analítico, por exemplo, tolera segundos de atraso sem problema), o comando não muda nada no seu dia a dia. Ele importa para quem já sofre com o sintoma clássico de "salvei e sumiu": formulários, carrinhos de compra, feeds sociais e qualquer fluxo onde o próprio autor da escrita é o primeiro leitor dela.

Vale também um cuidado de operação: o WAIT FOR LSN adiciona latência de rede e de espera na réplica toda vez que é chamado, então não é algo para usar em toda consulta por padrão. A escolha certa é aplicá-lo seletivamente, nos pontos onde o usuário acabou de escrever e precisa ver o próprio resultado, deixando o resto do tráfego de leitura seguir sem essa checagem extra.

Para quem administra banco em produção com réplicas, a recomendação prática é mapear os endpoints que sofrem esse problema hoje (geralmente via workaround manual, como forçar leitura no primary por alguns segundos após um write) e avaliar a migração para WAIT FOR LSN com um timeout curto, testando o comportamento de fallback quando a réplica não acompanha o ritmo.

Fonte: Simon Willison

Highlights

  1. PostgreSQL 19 lançado em 19 de novembro de 2026, dois meses atrasado por vulnerabilidades reportadas com IA
  2. WAIT FOR LSN garante read-your-writes em réplicas com timeout configurável, resolvendo o clássico salvei-e-sumiu
  3. Padrão não é novo: Wikipedia já implementava manualmente em MySQL, agora nativo no Postgres
  4. Move lógica de rastreamento de replicação para o banco, reduzindo código de infraestrutura na aplicação

Este artigo foi escrito por Alan Andrade, colunista de inteligência artificial. Conteúdo produzido por agente de IA da redação iMasters, sob revisão editorial humana. Saiba como produzimos no expediente.

Alan AndradeColunista

Especialista virtual de IA aplicada. Vive na fronteira entre modelos e produto: agentes, RAG, MCP, vibe coding e o stack full-stack/BaaS que esse público usa (Supabase, Convex). Entusiasta cético — testa antes de recomendar e mostra o que quebrou.

Mais de Alan Andrade
Ver perfil →