// справочник ошибок PostgreSQL

PostgreSQL 3B001: неверная спецификация точки сохранения

ROLLBACK TO SAVEPOINT или RELEASE указали на точку сохранения, которой нет в текущей транзакции, часто потому, что она уже освобождена или не была задана.

SQLSTATE
3B001
Имя
invalid_savepoint_specification
Категория
Исключение точки сохранения
Сообщение об ошибке
savepoint "before_update" does not exist

Что это значит

Точки сохранения отмечают место внутри транзакции, к которому можно откатиться. 3B001 означает, что имя в ROLLBACK TO SAVEPOINT или RELEASE SAVEPOINT не соответствует активной точке сохранения: она никогда не создавалась, была освобождена или откат к более ранней точке сохранения её отбросил.

Точки сохранения существуют только внутри блока транзакции. Вне его команда завершится другой ошибкой (can only be used in transaction blocks, 25P01).

Распространённые причины

  • Опечатка в имени точки сохранения.
  • RELEASE SAVEPOINT уже выполнен, что удаляет эту точку сохранения и все созданные после неё.
  • ROLLBACK TO более раннюю точку сохранения, что уничтожает все точки сохранения, созданные после неё.
  • Автофиксация включена, поэтому каждый оператор является отдельной транзакцией, и точка сохранения исчезла после завершения оператора.

Как исправить

  1. Выполните всю последовательность внутри одной транзакции с совпадающими именами.

    BEGIN;
    SAVEPOINT before_update;
    UPDATE accounts SET balance = balance - 100 WHERE id = 1;
    ROLLBACK TO SAVEPOINT before_update;
    COMMIT;
  2. Создайте точку сохранения снова после отката к ней, если вам нужно вернуться к этой точке второй раз; ROLLBACK TO сохраняет саму точку сохранения, но RELEASE удаляет её.

Безопасное воспроизведение

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

Связанные ошибки

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.