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

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

Wiki / SQL 命令

ROLLBACK TO SAVEPOINT

回滚到一个保存点

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

anchor
SQL-ROLLBACK-TO
file
sql-rollback-to.html
lang
en
name
ROLLBACK TO SAVEPOINT
purpose
roll back to a savepoint
purpose zh
未知
sections same as
未知
slug
18
synopsis html
ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] <em class="replaceable"><code>savepoint_name</code></em>
synopsis text
ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] savepoint_name

语法

ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] savepoint_name
语法图

从左向右阅读;分支表示选择,旁路表示可选,循环表示重复。点击带下划线的参数可打开对应规则。

ROLLBACK WORK TRANSACTION TO SAVEPOINT savepoint_name

版本定义 PG 18

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

另见

BEGIN, COMMIT, RELEASE SAVEPOINT, ROLLBACK, SAVEPOINT

比较版本

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c