SQL COMMAND · 事务控制
SAVEPOINT
在当前事务中定义一个新的保存点
SAVEPOINT事务控制引入 10(基线)现存至 20 devel0 次语法变更
- 动词
SAVEPOINT- 对象
—- 分组
- 事务控制
- 引入版本
- 10(基线)
- 状态
- 现存
- 语法变更次数
- 0
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
语法概要
SAVEPOINT savepoint_name
描述
SAVEPOINT在当前事务中建立一个新的保存点。
保存点是事务中的一种特殊标记,它允许回滚在其建立之后执行的所有命令, 从而将事务状态恢复到建立保存点时的状态。
参数
savepoint_name赋予新保存点的名称。如果已经存在同名保存点,则在较新的同名保存点被 释放之前,较旧的保存点将无法访问。
注解
使用ROLLBACK TO回滚到保存点。使用RELEASE SAVEPOINT 销毁保存点,同时保留其建立后执行的命令所产生的效果。
保存点只能在事务块内部建立。一个事务中可以定义多个保存点。
示例
要建立一个保存点,并在稍后撤销其建立后执行的所有命令的效果:
BEGIN;
INSERT INTO table1 VALUES (1);
SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (2);
ROLLBACK TO SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (3);
COMMIT;
上述事务将插入值 1 和 3,而不会插入 2。
要建立保存点,并在稍后销毁它:
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 my_savepoint;
INSERT INTO table1 VALUES (2);
SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (3);
-- 回滚到第二个保存点
ROLLBACK TO SAVEPOINT my_savepoint;
SELECT * FROM table1; -- 显示值为 1 和 2 的行
-- 释放第二个保存点
RELEASE SAVEPOINT my_savepoint;
-- 回滚到第一个保存点
ROLLBACK TO SAVEPOINT my_savepoint;
SELECT * FROM table1; -- 仅显示值为 1 的行
COMMIT;
上述事务展示了先回滚值为 3 的行,再回滚值为 2 的行。
兼容性
SQL 要求在建立另一个同名保存点时自动销毁原有保存点。在 PostgreSQL中,旧保存点会被保留,不过在回滚或 释放时只会使用最近建立的那个。(如果使用 RELEASE SAVEPOINT释放较新的保存点,较旧的保存点将再次 可供 ROLLBACK TO SAVEPOINT 和 RELEASE SAVEPOINT 使用。)除此之外, SAVEPOINT 完全符合 SQL。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
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 | — | |
| 开始一个事务块 | 现存 | |||