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 является обязательным, но Postgres Pro Shardman позволяет опускать его.
См. также
BEGIN, COMMIT, ROLLBACK, ROLLBACK TO SAVEPOINT, SAVEPOINTRELEASE SAVEPOINT
RELEASE SAVEPOINT — release a previously defined savepoint
Synopsis
RELEASE [ SAVEPOINT ] savepoint_name
Description
RELEASE SAVEPOINT releases the named savepoint and all active savepoints that were created after the named savepoint, and frees their resources. All changes made since the creation of the savepoint that didn't already get rolled back are merged into the transaction or savepoint that was active when the named savepoint was created. Changes made after RELEASE SAVEPOINT will also be part of this active transaction or savepoint.
Parameters
savepoint_nameThe name of the savepoint to release.
Notes
Specifying a savepoint name that was not previously defined is an error.
It is not possible to release a savepoint when the transaction is in an aborted state; to do that, use ROLLBACK TO SAVEPOINT.
If multiple savepoints have the same name, only the most recently defined unreleased one is released. Repeated commands will release progressively older savepoints.
Examples
To establish and later release a savepoint:
BEGIN;
INSERT INTO table1 VALUES (3);
SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (4);
RELEASE SAVEPOINT my_savepoint;
COMMIT;
The above transaction will insert both 3 and 4.
A more complex example with multiple nested subtransactions:
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))); -- generates an error
In this example, the application requests the release of the savepoint sp2, which inserted 3. This changes the insert's transaction context to sp1. When the statement attempting to insert value 4 generates an error, the insertion of 2 and 4 are lost because they are in the same, now-rolled back savepoint, and value 3 is in the same transaction context. The application can now only choose one of these two commands, since all other commands will be ignored:
ROLLBACK; ROLLBACK TO SAVEPOINT sp1;
Choosing ROLLBACK will abort everything, including value 1, whereas ROLLBACK TO SAVEPOINT sp1 will retain value 1 and allow the transaction to continue.
Compatibility
This command conforms to the SQL standard. The standard specifies that the key word SAVEPOINT is mandatory, but Postgres Pro Shardman allows it to be omitted.
