SQL COMMAND · 事务控制
RELEASE SAVEPOINT
释放一个先前定义的保存点
RELEASE事务控制引入 10(基线)现存至 20 devel0 次语法变更
- 动词
RELEASE- 对象
SAVEPOINT- 分组
- 事务控制
- 引入版本
- 10(基线)
- 状态
- 现存
- 语法变更次数
- 0
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
语法概要
RELEASE [ SAVEPOINT ] savepoint_name
描述
RELEASE SAVEPOINT释放指定名称的保存点,以及在该保存点之后创建且仍处于活动状态的所有保存点,并释放它们占用的资源。 自该保存点创建以来所做、且之前尚未被回滚的所有更改,都会并入在创建该保存点时处于活动状态的事务或保存点中。 在RELEASE SAVEPOINT之后所做的更改,也将成为该活动事务或保存点的一部分。
参数
savepoint_name要释放的保存点名称。
注解
指定一个此前未定义的保存点名称是一种错误。
当事务处于已中止状态时,不能释放保存点;要这样做,请使用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))); -- generates an error
在这个例子中,应用程序请求释放保存点sp2,值 3 是在其中插入的。 这样会把该插入操作的事务上下文改为sp1。 当试图插入值 4 的语句产生错误时,2 和 4 的插入都会丢失,因为它们位于同一个随后被回滚的保存点中, 而值 3 现在也位于同一事务上下文中,因此同样会丢失。 由于此后所有其他命令都会被忽略,应用程序现在只能在以下两个命令中选择一个:
ROLLBACK; ROLLBACK TO SAVEPOINT sp1;
选择ROLLBACK将中止所有内容,包括值 1; 而ROLLBACK TO SAVEPOINT sp1会保留值 1,并允许事务继续。
兼容性
该命令符合SQL标准。 标准规定关键字SAVEPOINT是强制的, 但PostgreSQL允许省略它。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 14← 13正文更新
正文更新
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
ABORT | ABORT | — | 121 次 | |
| 中止当前事务 | 现存 | |||
BEGIN | BEGIN | — | — | |
| 开始一个事务块 | 现存 | |||
COMMIT | COMMIT | — | 121 次 | |
| 提交当前事务 | 现存 | |||
END | END | — | 121 次 | |
| 提交当前事务 | 现存 | |||
ROLLBACK | ROLLBACK | — | 121 次 | |
| 中止当前事务 | 现存 | |||
SAVEPOINT | SAVEPOINT | — | — | |
| 在当前事务中定义一个新的保存点 | 现存 | |||
SET CONSTRAINTS | SET | CONSTRAINTS | — | |
| 为当前事务设置约束检查时机 | 现存 | |||
WAIT FOR | WAIT | FOR | — | |
| 等待 WAL 达到目标 LSN | 现存 | |||
COMMIT PREPARED | COMMIT | PREPARED | — | |
| 提交一个先前为两阶段提交而预备的事务 | 现存 | |||
ROLLBACK PREPARED | ROLLBACK | PREPARED | — | |
| 回滚一个先前为两阶段提交而预备的事务 | 现存 | |||
RELEASE SAVEPOINT | RELEASE | SAVEPOINT | — | |
| 释放一个先前定义的保存点 | 现存 | |||
ROLLBACK TO SAVEPOINT | ROLLBACK | TO SAVEPOINT | — | |
| 回滚到一个保存点 | 现存 | |||
PREPARE TRANSACTION | PREPARE | TRANSACTION | — | |
| 为两阶段提交准备当前事务 | 现存 | |||
SET TRANSACTION | SET | TRANSACTION | — | |
| 设置当前事务的特性 | 现存 | |||
START TRANSACTION | START | TRANSACTION | — | |
| 开始一个事务块 | 现存 | |||