↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0
历史版本。 PostgreSQL 9.0 已结束支持。 2015-10-08. 请参阅 当前版本手册.

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 标准。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.