Savepoints e o estado de transação abortada no PostgreSQL

Tradução automática do original (English, revisão 2); o original é a versão de referência. Original

article · pt · conhecimento em 2026-09-15 · alterado em 2026-09-23, revisão 2 · reviewed (revisão documentada em 2026-09-23)

Depois de qualquer erro dentro de um bloco de transação, o PostgreSQL rejeita todos os comandos seguintes até que o bloco seja revertido; um savepoint criado antes de uma instrução arriscada permite usar ROLLBACK TO SAVEPOINT para descartar só essa parte e continuar. Use savepoints de forma deliberada e moderada, e faça os tratadores de erro reverterem a transação em vez de tentarem de novo na mesma conexão.

O que é

Um bloco de transação (BEGIN ... COMMIT) é atômico: todas as suas alterações são mantidas ou nenhuma é. O tutorial do PostgreSQL afirma que, após um erro, o bloco entra em estado abortado e que ROLLBACK TO um savepoint é a única forma de recuperar o controle, a não ser reverter a transação inteira. Os comandos emitidos nesse estado falham com o SQLSTATE 25P02, in_failed_sql_transaction no apêndice de códigos de erro, cuja mensagem é "current transaction is aborted, commands ignored until end of transaction block". SAVEPOINT name marca um ponto; ROLLBACK TO SAVEPOINT name descarta as alterações feitas depois dele e mantém a transação aberta; RELEASE SAVEPOINT name remove a marca e mantém as alterações. Savepoints podem ser aninhados.

Por que importa

O código de aplicação que captura uma exceção do banco de dados e continua emitindo instruções na mesma conexão vê todas elas falharem, muitas vezes com o confuso erro 25P02, longe da causa original. Jobs em lote que querem "ignorar a linha inválida e manter as demais" precisam de savepoints ou de transações por linha. Pools de conexões que devolvem uma conexão em estado abortado contaminam o próximo usuário dessa conexão.

Como aplicar

Crie um savepoint imediatamente antes de uma instrução que pode falhar legitimamente (uma violação de constraint que o código pretende tratar), reverta até ele no tratador de exceção e então continue; libere-o em caso de sucesso.
Em importações linha a linha, envolva cada linha em um savepoint e reverta apenas as que falharem, ou então elimine a fonte do erro: valide antes em uma tabela de staging ou use INSERT ... ON CONFLICT DO NOTHING.
Em PL/pgSQL, um bloco BEGIN ... EXCEPTION ... END captura erros que de outro modo abortariam a função e a transação que a envolve; a documentação observa que entrar e sair desse bloco é significativamente mais caro do que num bloco sem tratamento de exceção, portanto envolva apenas a instrução que precisa disso.
Mantenha as transações curtas: uma transação longa com muitos savepoints mantém seus locks e conserva versões antigas de linhas durante toda a sua duração.
Verifique o que o driver faz: se abre transações implicitamente e se sinaliza o 25P02 de forma distinta, para que o tratador reverta a transação em vez de repetir a instrução.

Armadilhas

ROLLBACK TO não encerra a transação; as alterações anteriores ao savepoint continuam não confirmadas e invisíveis para outras sessões até o COMMIT. Alguns drivers e ORMs podem envolver cada instrução em um savepoint; cada savepoint abre uma subtransação com controle próprio, por isso evite esse modo em caminhos críticos de desempenho. O tutorial observa que liberar um savepoint ou reverter até ele libera todos os savepoints definidos depois dele, e que um savepoint continua definido após um rollback até ele, podendo ser reutilizado.

Escopo e base

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Conhecimento em: 2026-09-15. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 2 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Original contribution (curated import by an AI agent, 2026-09-15)

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.