PostgreSQL 19 troca VACUUM FULL por REPACK e acrescenta get or create nativo
A nova versão traz REPACK sem bloqueio para reindexar e compactar tabelas, INSERT ... ON CONFLICT DO SELECT para resolver busca-ou-cria em uma única consulta, e extensões que travam o plano de execução sem mexer no código da aplicação.
Ao final deste texto você vai saber trocar VACUUM FULL e CLUSTER por REPACK sem travar sua tabela em produção, escrever um INSERT ... ON CONFLICT DO SELECT para resolver get-or-create numa única consulta, e usar as extensões pg_plan_advice e pg_stash_advice para travar um plano de execução sem tocar no código da aplicação. Os exemplos abaixo valem para PostgreSQL 19, lançado em 19 de novembro de 2026, segundo o anúncio reproduzido pela newsletter Postgres Weekly (edição 674).
REPACK substitui VACUUM FULL e CLUSTER sem travar a tabela
Até o PostgreSQL 18, zerar o inchaço (bloat) de uma tabela grande significava rodar VACUUM FULL ou CLUSTER, os dois pegando um lock ACCESS EXCLUSIVE que bloqueia leitura e escrita até terminar. No PostgreSQL 19, o comando REPACK faz o mesmo trabalho (compactar a tabela e, opcionalmente, reordenar fisicamente as linhas para casar com um índice) e, com a opção CONCURRENTLY, libera leituras e escritas durante praticamente toda a operação, bloqueando só no instante final da troca de arquivos. VACUUM FULL e CLUSTER continuam existindo, mas só por compatibilidade: a documentação já trata REPACK como o caminho recomendado.
-- Esquema mínimo para reproduzir
CREATE TABLE pedidos (
id serial PRIMARY KEY,
cliente_id integer NOT NULL,
status text NOT NULL,
criado_em timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX idx_pedidos_cliente ON pedidos (cliente_id);
-- Antes (PostgreSQL até a versão 18): trava a tabela inteira
VACUUM FULL pedidos;
-- PostgreSQL 19: mesma reorganização, sem bloquear leituras e escritas até a troca final
REPACK (CONCURRENTLY) pedidos;
-- Reordenar fisicamente as linhas para casar com um índice (substitui CLUSTER)
REPACK (CONCURRENTLY) pedidos USING idx_pedidos_cliente;Para confirmar que a tabela ficou disponível durante a operação, abra uma segunda sessão e consulte pg_locks enquanto o REPACK roda:
SELECT pid, mode, granted, relation::regclass
FROM pg_locks
WHERE relation = 'pedidos'::regclass;O esperado é não ver um lock ACCESS EXCLUSIVE até a etapa final de troca dos arquivos físicos. É esse REPACK, e não VACUUM FULL, que vale a pena colocar na rotina de manutenção de tabelas grandes em produção a partir de agora.
INSERT ... ON CONFLICT DO SELECT: get-or-create em uma única ida ao banco
O padrão "busca ou cria" (uma tag, uma linha de configuração, um registro de cache) sempre forçou uma escolha ruim no PostgreSQL: ou duas idas ao banco (um SELECT, e se não achar, um INSERT), ou uma CTE combinando INSERT ... ON CONFLICT DO NOTHING RETURNING com um SELECT de fallback via UNION ALL. O PostgreSQL 19 adiciona a cláusula DO SELECT, que resolve isso numa única instrução.
CREATE TABLE tags (
id serial PRIMARY KEY,
nome text UNIQUE NOT NULL
);
-- Antes do PostgreSQL 19: duas idas ao banco, ou uma CTE com UNION ALL
WITH nova AS (
INSERT INTO tags (nome) VALUES ('backend')
ON CONFLICT (nome) DO NOTHING
RETURNING id, nome
)
SELECT id, nome FROM nova
UNION ALL
SELECT id, nome FROM tags
WHERE nome = 'backend' AND NOT EXISTS (SELECT 1 FROM nova);
-- PostgreSQL 19: get-or-create em uma única instrução
INSERT INTO tags (nome) VALUES ('backend')
ON CONFLICT (nome) DO SELECT
RETURNING id, nome;Na prática, o fluxo passa a ser: você identifica o queryid problemático com pg_stat_statements, grava uma recomendação de plano com pg_plan_advice (por exemplo, forçar um Index Scan em vez de Seq Scan) e deixa o pg_stash_advice aplicar essa recomendação toda vez que aquele queryid aparecer de novo, sem precisar alterar a consulta original na aplicação.
Vale lembrar: ON CONFLICT DO SELECT é sintaxe específica do PostgreSQL, não existe em padrão SQL nem em MySQL ou SQL Server. Quem mantém código que roda nos dois lados (um serviço em Postgres, outro em MySQL, por exemplo) continua precisando da versão portável com duas consultas para os bancos que não têm esse recurso.
pg_plan_advice e pg_stash_advice: travar o plano sem tocar no código
Plano de execução muda sozinho: estatística desatualizada, autovacuum rodando, crescimento da tabela, tudo isso pode fazer o planejador trocar um Index Scan rápido por um Seq Scan lento do dia para a noite, sem que uma linha de código da aplicação tenha mudado. Até o PostgreSQL 18, a única saída era reescrever a consulta com dicas informais (reordenar JOINs, forçar OFFSET 0 em subconsultas) ou depender de extensões de terceiros.
-- Antes: confira o plano atual e o tempo real de execução
EXPLAIN (ANALYZE, BUFFERS)
SELECT * FROM pedidos WHERE cliente_id = 42;
-- Encontre o identificador estável da consulta (requer pg_stat_statements)
SELECT queryid, query FROM pg_stat_statements
WHERE query LIKE '%cliente_id%';Com pg_plan_advice instalado, você associa uma recomendação de plano a esse queryid e testa o efeito sem alterar a consulta original. Com pg_stash_advice no ar, a mesma recomendação passa a ser aplicada automaticamente sempre que o queryid aparecer de novo — útil para corrigir um plano ruim em produção sem esperar um deploy. Depois de aplicar, rode o mesmo EXPLAIN (ANALYZE, BUFFERS) de novo e compare o nó do plano e o tempo real: é essa comparação antes/depois que confirma se a recomendação pegou.
Outras mudanças que valem registrar
- Replicação lógica sem reiniciar: pode ser ligada em uma instância já no ar, sem exigir restart do servidor.
- Sequences replicadas:
sequences agora acompanham a replicação lógica, o que elimina um ajuste manual clássico depois de uma migração. WAIT FOR LSN: dá consistência de leitura-após-escrita (read-your-writes) em réplicas (standbys), útil para quem lê de um replica logo depois de escrever no primário.COPYcom saída em JSON: facilita exportar resultado de consulta direto para consumo por outra aplicação.- Funções de janela com
IGNORE NULLS: simplifica consultas analíticas que hoje precisam deCASE WHENpara pular valores nulos.
Antes de migrar: o que pode travar o upgrade
- Reindexar depois do
pg_upgrade: índices de busca textual,pg_trgmefuzzystrmatchpodem precisar deREINDEXdepois da migração. Jeff Davis explica que não existe checagem automática dopg_upgradepara esse caso específico, então o ônus é verificar manualmente. pg_upgrade --checkpode passar e o upgrade falhar mesmo assim: acontece quando uma role ou banco usastandard_conforming_strings = off, ou quando o projeto tinha um cast próprio deuuidparabytea(agora embutido no PostgreSQL 19, o que gera conflito).- Rode
VACUUM ANALYZEdepois de umpg_restore: Nikolay relatou uma consulta que levou 32,6 segundos sem esse passo, contra 23 milissegundos depois de rodarVACUUM ANALYZE— a primeira leitura após uma restauração fica especialmente cara no PostgreSQL 19. - JIT agora vem desligado por padrão: as estimativas de custo que decidiam quando compilar (JIT) se mostraram pouco confiáveis. Quem roda muita consulta analítica pesada pode precisar religar manualmente.
Minor releases, fim de vida do PostgreSQL 14 e um CVE crítico
Junto com a versão 19, saíram as versões 18.7, 17.12, 16.16, 15.20 e 14.25, corrigindo 52 problemas de segurança — e essa é a última rodada de patches do PostgreSQL 14, que chega ao fim de vida.
Um dos problemas corrigidos é o CVE-2026-6460, uma confusão de tipo (type confusion) com 22 anos de existência no núcleo do PostgreSQL: Mehmet Ince demonstrou como explorar uma extensão num serviço gerenciado para alterar o campo de um tipo composto e ler de volta o valor antigo, conseguindo execução remota de código de forma confiável. Quem administra qualquer versão suportada do PostgreSQL (não só a 19) deveria aplicar esses patches o quanto antes, e lembrar que extensões precisam ser atualizadas junto com o servidor, não depois.
Próximo passo
Antes de aplicar REPACK em produção, teste o comando contra uma cópia da tabela mais problemática do seu banco e confira o comportamento de locks descrito acima. Se você constrói extensões em Rust, vale olhar o pgrx 0.20, já compatível com PostgreSQL 19. E se o seu ambiente depende de pgAudit para trilha de auditoria, confirme a versão 19.0 antes de migrar — é a que já suporta essa major. As notas de lançamento oficiais do PostgreSQL 19 continuam sendo a referência final para qualquer detalhe de sintaxe que este texto não cobriu.
Fonte: Postgres Weekly
Este artigo foi escrito por Patrícia Guimarães. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.
Editora virtual de Banco de dados do Linha de Código. Cobre SQL de verdade — consulta, índice, transação, plano de execução — em PostgreSQL, MySQL, SQL Server, MongoDB e Redis, e a modelagem que evita o problema antes dele existir. Escreve para o desenvolvedor que também é o DBA da empresa.