RELEASE SAVEPOINT

RELEASE SAVEPOINT — высвободить ранее определённую точку сохранения

Синтаксис

RELEASE [ SAVEPOINT ] имя_точки_сохранения

Описание

Команда RELEASE SAVEPOINT освобождает указанную точку сохранения и все активные точки сохранения, созданные после указанной, а также освобождает соответствующие ресурсы. Все изменения, сделанные с момента создания точки сохранения (но не отменённые), объединяются в транзакцию или в точку сохранения, активную на момент создания указанной точки сохранения. Изменения, сделанные после RELEASE SAVEPOINT, также включаются в активную транзакцию или точку сохранения.

Параметры

имя_точки_сохранения

Имя точки сохранения, подлежащей освобождению.

Примечания

Указание имени точки сохранения, не определённой ранее, считается ошибкой.

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

Если одно имя дано нескольким ранее определённым точкам сохранения, освобождена будет только последняя из них. Повторные команды будут последовательно освобождать более ранние точки сохранения.

Примеры

Этот пример показывает, как установить и затем освободить точку сохранения:

BEGIN;
    INSERT INTO table1 VALUES (3);
    SAVEPOINT my_savepoint;
    INSERT INTO table1 VALUES (4);
    RELEASE SAVEPOINT my_savepoint;
COMMIT;

Данная транзакция вставит значения 3 и 4.

Более сложный пример с несколькими вложенными подтранзакциями:

BEGIN;
    INSERT INTO table1 VALUES (1);
    SAVEPOINT sp1;
    INSERT INTO table1 VALUES (2);
    SAVEPOINT sp2;
    INSERT INTO table1 VALUES (3);
    RELEASE SAVEPOINT sp2;
    INSERT INTO table1 VALUES (4))); -- выдаст ошибку

В этом примере приложение запрашивает освобождение точки сохранения sp2, добавившей 3. При этом контекст добавляющей транзакции изменится на sp1. Когда оператор, добавляющий 4, выдаст ошибку, добавление значений 2 и 4 будет потеряно, поскольку они входят в отменённую точку сохранения, а значение 3 находится в том же транзакционном контексте. Поскольку остальные команды игнорируются, приложение может выбрать только одну из следующих двух команд:

ROLLBACK;
ROLLBACK TO SAVEPOINT sp1;

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

Совместимость

Эта команда соответствует стандарту SQL. В стандарте говорится, что ключевое слово SAVEPOINT является обязательным, но PostgreSQL позволяет опускать его.