// Referência de erro do PostgreSQL

PostgreSQL 3B001: especificação de savepoint inválida

ROLLBACK TO SAVEPOINT ou RELEASE referenciou um savepoint que não existe na transação atual, frequentemente porque ele já foi liberado ou nunca foi definido.

SQLSTATE
3B001
Nome
invalid_savepoint_specification
Categoria
Exceção de savepoint
Mensagem de erro
savepoint "before_update" does not exist

O que significa

Savepoints marcam um ponto dentro de uma transação ao qual você pode reverter. 3B001 significa que o nome em ROLLBACK TO SAVEPOINT ou RELEASE SAVEPOINT não corresponde a um savepoint ativo: ele nunca foi criado, foi liberado ou um rollback para um savepoint anterior o descartou.

Savepoints só existem dentro de um bloco de transação. Fora dele, o comando falha com um erro diferente (can only be used in transaction blocks, 25P01).

Causas comuns

  • Um erro de digitação no nome do savepoint.
  • RELEASE SAVEPOINT já foi executado, o que remove esse savepoint e qualquer um criado depois dele.
  • ROLLBACK TO um savepoint anterior, o que destrói os savepoints criados depois dele.
  • O autocommit está ativado, então cada instrução é uma transação própria e o savepoint desapareceu quando a instrução terminou.

Como corrigir

  1. Execute a sequência inteira dentro de uma transação, com nomes correspondentes.

    BEGIN;
    SAVEPOINT before_update;
    UPDATE accounts SET balance = balance - 100 WHERE id = 1;
    ROLLBACK TO SAVEPOINT before_update;
    COMMIT;
  2. Crie o savepoint novamente depois de fazer rollback até ele, se você precisar voltar a esse ponto uma segunda vez; ROLLBACK TO mantém o próprio savepoint, mas RELEASE o remove.

Reproduza com segurança

BEGIN;
ROLLBACK TO SAVEPOINT nope;  -- ERROR: savepoint "nope" does not exist
ROLLBACK;

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.