受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

ROLLBACK TO SAVEPOINT

ROLLBACK TO SAVEPOINT — 回滚到一个保存点

Synopsis

ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] savepoint_name

描述

回滚该保存点建立后执行的所有命令,然后在同一事务层级启动一个新的 子事务。该保存点仍然有效,如有需要,之后还可以再次回滚到它。

ROLLBACK TO SAVEPOINT会隐式销毁在指定保存点之后建立的所有保存点。

参数

savepoint_name #

要回滚到的保存点名称。

注解

使用RELEASE SAVEPOINT可以销毁一个保存点, 而不丢弃在它建立之后执行的命令所产生的效果。

指定一个尚未建立的保存点名称是一种错误。

就保存点而言,游标带有一些非事务性的行为。凡是在某个保存点内打开的游标, 在回滚该保存点时都会被关闭。如果先前打开的游标在某个随后又被回滚的保存点内受到了 FETCHMOVE命令的影响,那么该游标会保留在这些命令使其指向的位置上 (也就是说,由FETCHMOVE引起的游标移动不会被回滚)。 关闭游标同样不会因回滚而撤销。不过,如果游标查询导致了其他副作用(例如该查询调用的 易变函数带来的副作用),且这些副作用发生在后来被回滚的保存点期间,那么它们 被回滚。如果某个游标的执行导致事务中止,该游标会进入不可执行状态, 因此即使事务可以通过ROLLBACK TO SAVEPOINT恢复,该游标也不能再使用。

示例

要撤销在my_savepoint建立后执行的命令的效果:

ROLLBACK TO SAVEPOINT my_savepoint;

游标位置不受保存点回滚的影响:

BEGIN;

DECLARE foo CURSOR FOR SELECT 1 UNION SELECT 2;

SAVEPOINT foo;

FETCH 1 FROM foo;
 ?column?
----------
        1

ROLLBACK TO SAVEPOINT foo;

FETCH 1 FROM foo;
 ?column?
----------
        2

COMMIT;

兼容性

SQL标准规定关键字SAVEPOINT是强制的,但 PostgreSQLOracle允许省略它。 SQL 只允许在ROLLBACK之后使用WORK作为噪声词, 不允许使用TRANSACTION。此外,SQL 还有一个可选子句 AND [ NO ] CHAIN,而PostgreSQL当前尚不支持。 除此之外,该命令符合 SQL 标准。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。