PostgreSQL 19: blog da pgEdge detalha o REPACK CONCURRENTLY, que promete reconstruir tabelas sem bloquear a aplicação
Segundo post de Ahsan Hadi no blog da pgEdge, veja como testar a opção CONCURRENTLY sem travar leitura e escrita, e por que ela não é a mesma coisa que REINDEX CONCURRENTLY.
Segundo post de Ahsan Hadi no blog da pgEdge, veja como testar a opção CONCURRENTLY sem travar leitura e escrita, e por que ela não é a mesma coisa que REINDEX CONCURRENTLY.
Veja como testar a opção CONCURRENTLY sem travar leitura e escrita, segundo um post do blog da pgEdge, e por que ela não é a mesma coisa que REINDEX CONCURRENTLY.
Nota da redação: a fonte consultada identifica Ahsan Hadi apenas como autor do post, sem mencionar o cargo de cofundador da pgEdge. Essa atribuição específica não pôde ser confirmada e o leitor deve considerá-la não verificada.
O PostgreSQL 19 foi lançado em 19 de novembro de 2026. A mudança mais comentada para quem cuida de tabelas inchadas em produção, segundo um post publicado por Ahsan Hadi, cofundador da pgEdge, no blog da empresa, é um comando novo: REPACK. De acordo com o post, ele substitui VACUUM FULL e CLUSTER, e com a opção CONCURRENTLY reconstrói uma tabela sem bloquear leitura e escrita.
As notas de release oficiais do projeto PostgreSQL não foram incluídas nesta apuração, então os detalhes técnicos abaixo refletem o que o post da pgEdge descreve. Este texto mostra como reproduzir o teste, o que REPACK CONCURRENTLY exige segundo essa fonte, e por que ele não é a mesma coisa que REINDEX CONCURRENTLY. Os exemplos abaixo valem para PostgreSQL 19.
VACUUM FULL e CLUSTER sempre travaram a tabela inteira
VACUUM FULL e CLUSTER sempre precisaram de um AccessExclusiveLock na tabela inteira durante toda a reconstrução. Numa tabela grande e inchada por muitos UPDATE e DELETE, isso significa uma janela de indisponibilidade real, e por isso times evitavam rodar esses comandos em horário comercial. A fonte não detalha o comportamento de REPACK quando rodado sem a opção CONCURRENTLY, mas é razoável supor, dado que o comando substitui diretamente os dois antigos, que o caminho sem CONCURRENTLY preserve um comportamento de bloqueio semelhante. A diferença relevante, segundo o post da pgEdge, aparece quando você adiciona CONCURRENTLY ao comando.
O que REPACK CONCURRENTLY exige
O REPACK CONCURRENTLY tem duas condições que valem a pena conferir antes de rodar em produção, segundo o post de Ahsan Hadi:
- A tabela precisa ter uma chave primária ou um índice de replica identity, segundo o post; é essa chave que permite identificar as linhas durante a cópia.
- O post também observa que o comando não é seguro sob MVCC para transações que começaram antes da troca da tabela (o "swap"). Na prática, isso pode significar que uma transação longa aberta antes do
REPACKterminar enxergue um estado inconsistente entre a tabela antiga e a nova.
Antes de rodar em produção, vale checar pg_stat_activity por transações antigas em aberto (xact_start distante do agora) e evitar o REPACK CONCURRENTLY enquanto elas existirem.
Testando num esquema mínimo
Nota da redação: o código desta seção não foi executado em ambiente real. Valide antes de usar em produção.
Para reproduzir o comportamento, uma tabela simples com chave primária já é suficiente:
-- esquema mínimo para reproduzir (PostgreSQL 19)
CREATE TABLE pedidos (
id bigint PRIMARY KEY,
cliente_id bigint NOT NULL,
valor numeric(10,2) NOT NULL,
criado_em timestamptz DEFAULT now()
);
-- depois de muitos UPDATE/DELETE, a tabela acumula tuplas mortas
SELECT relname, n_dead_tup, n_live_tup
FROM pg_stat_user_tables
WHERE relname = 'pedidos';Com a tabela inchada, o comando de reconstrução concorrente é:
REPACK (CONCURRENTLY) pedidos;
-- confira que o bloat sumiu
SELECT relname, n_dead_tup, n_live_tup
FROM pg_stat_user_tables
WHERE relname = 'pedidos';Para confirmar que nada travou durante a execução, abra outra sessão e rode INSERT ou UPDATE na mesma tabela enquanto o REPACK roda. Para monitorar, use o parâmetro log_lock_waits (segundo o post da pgEdge, agora ligado por padrão no PostgreSQL 19), que registra avisos quando uma sessão fica esperando um bloqueio por muito tempo, ou consulte a view pg_stat_lock, que o mesmo post descreve como novidade desta versão, para ver se alguma sessão ficou esperando.
REPACK não é REINDEX CONCURRENTLY
Vale um alerta de nomenclatura, porque os dois termos se confundem na hora de procurar documentação. O REINDEX CONCURRENTLY reconstrói só um índice, sem travar a tabela durante o processo. O REPACK CONCURRENTLY, apresentado pelo post da pgEdge como novidade do PostgreSQL 19, reconstrói a tabela inteira (o heap e seus índices), substituindo o par VACUUM FULL e CLUSTER. São operações diferentes, para problemas diferentes: inchaço de índice isolado pede REINDEX CONCURRENTLY; tabela inteira inchada pede REPACK CONCURRENTLY.
O que Ahsan Hadi mediu testando as release candidates
Ahsan Hadi, autor do post, acompanhou as release candidates do PostgreSQL 19 por semanas antes do lançamento e relatou o resultado de um teste próprio com REPACK CONCURRENTLY:
As inserções continuaram rodando a cerca de 2.000 por segundo, sem nenhuma transação falhar, enquanto uma tabela inchada foi reconstruída em menos de um segundo.
In my own test, inserts kept running at about 2,000 a second with no failed transactions while a bloated table was rebuilt in under a second.Ahsan Hadi, autor do post, blog da pgEdge
O número não substitui o seu próprio teste de carga, mas dá uma referência de ordem de grandeza para comparar contra o que você medir no seu workload.
Antes de migrar, confira os defaults que mudaram
Além do REPACK, o post da pgEdge lista mudanças de valores padrão que, segundo Ahsan Hadi, afetam monitoramento e comportamento de lock no PostgreSQL 19. Vale conferir antes de promover para produção:
| Parâmetro | Antes | PostgreSQL 19 (segundo o post) |
|---|---|---|
| JIT | ligado por padrão | desligado por padrão |
max_locks_per_transaction | n/d | 128 |
standard_conforming_strings | configurável | sempre ligado |
sync_error_count (em pg_stat_subscription_stats) | nome antigo | renomeado para sync_table_error_count |
Esse último item, segundo o post, quebra silenciosamente qualquer painel ou alerta que consulte pg_stat_subscription_stats pelo nome antigo da coluna. Se você monitora replicação lógica, vale revisar essa mudança antes de migrar.
Atualize os patches antes de pensar no major
Independente de quando você for para o PostgreSQL 19, as atualizações de 12 de novembro de 2026 (PostgreSQL 18.7, 17.12, 16.16 e 15.20) corrigiram 52 vulnerabilidades de segurança e mais de 140 bugs, incluindo correções para backups incrementais que podiam gerar backup corrompido. Quem aplicou esse patch deve tirar um novo backup completo, já que backups incrementais feitos antes da correção podem estar comprometidos. O PostgreSQL 14 chegou ao fim de vida na versão 14.25: quem ainda está nessa major precisa planejar uma migração.
Próximo passo
Para entender o restante das mudanças de PostgreSQL 19, como a publicação de sequências com ALL SEQUENCES, o retain_dead_tuples em subscrições e os novos pg_plan_advice e pg_stash_advice, recursos citados no post de Ahsan Hadi, as notas de release oficiais do projeto são a referência completa para confirmar os detalhes técnicos.
Shaun Thomas detalhou boa parte dessas mudanças com mais contexto na série "Looking Forward to PostgreSQL 19" no blog da pgEdge. Para quem roda cluster com Spock, a pgEdge documentou os dois caminhos de upgrade (rolling e in-place) usando a migração de 17 para 18 como exemplo, incluindo o detalhe de que o pg_upgrade não recria as origens de replicação do Spock automaticamente.
Fonte: Planet PostgreSQL
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.