ROLLBACK TO SAVEPOINT
ROLLBACK TO SAVEPOINT — 回滚到一个保存点
大纲
ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] savepoint_name
描述
回滚该保存点建立后执行的所有命令。该保存点仍然有效,如有需要,之后还可以再次回滚到它。
ROLLBACK TO SAVEPOINT 会隐式销毁在指定保存点之后建立的所有保存点。
参数
savepoint_name#要回滚到的保存点名称。
注解
使用 RELEASE SAVEPOINT 可以销毁一个保存点,而不丢弃在它建立之后执行的命令所产生的效果。
指定一个尚未建立的保存点名称是一种错误。
就保存点而言,游标带有一些非事务性的行为。凡是在某个保存点内打开的游标,在回滚该保存点时都会被关闭。如果先前打开的游标在某个随后又被回滚的保存点内受到了
FETCH 或 MOVE 命令的影响,那么该游标会保留在 FETCH 使其指向的位置上(也就是说,由 FETCH 引起的游标移动不会被回滚)。关闭游标同样不会因回滚而撤销。不过,如果游标查询导致了其他副作用(例如该查询调用的易变函数带来的副作用),且这些副作用发生在后来被回滚的保存点期间,那么它们会被回滚。如果某个游标的执行导致事务中止,该游标会进入不可执行状态,因此即使事务可以通过 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 是强制的,但
PostgreSQL 和 Oracle 允许省略它。SQL 只允许在 ROLLBACK 之后使用 WORK 作为噪声词,不允许使用 TRANSACTION。此外,SQL 还有一个可选子句
AND [ NO ] CHAIN,而 PostgreSQL 当前尚不支持。除此之外,该命令符合 SQL 标准。
报告文档问题
阅读 上游文档. 通过 PostgreSQL 文档反馈表单.