↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / SQL 命令 / 事务控制

SQL COMMAND · 事务控制

RELEASE SAVEPOINT

释放一个先前定义的保存点

RELEASE事务控制引入 10(基线)现存至 20 devel0 次语法变更

动词
RELEASE
对象
SAVEPOINT
引入版本
10(基线)
状态
现存
语法变更次数
0
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

RELEASE SAVEPOINT savepoint_name

语法概要

RELEASE [ SAVEPOINT ] savepoint_name

PostgreSQL 18 手册 · 查看完整参考页

描述

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))); -- 产生错误

在这个例子中,应用程序请求释放保存点sp2,值 3 是在其中插入的。这样会把该插入操作的事务上下文改为sp1。当试图插入值 4 的语句产生错误时,2 和 4 的插入都会丢失,因为它们位于同一个随后被回滚的保存点中,而值 3 现在也位于同一事务上下文中,因此同样会丢失。由于此后所有其他命令都会被忽略,应用程序现在只能在以下两个命令中选择一个:

ROLLBACK;
ROLLBACK TO SAVEPOINT sp1;

选择ROLLBACK将中止所有内容,包括值 1;而ROLLBACK TO SAVEPOINT sp1会保留值 1,并允许事务继续。

兼容性

该命令符合SQL标准。标准规定关键字SAVEPOINT是强制的,但PostgreSQL允许省略它。

另见

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 17← 16正文更新

    正文更新
  2. PostgreSQL 16← 15正文更新

    正文更新

同组命令

命令动词对象版本变动最近变更
TRANSACTIONS事务控制14 条↑
ABORTABORT— 121 次
中止当前事务现存
BEGINBEGIN— —
开始一个事务块现存
COMMITCOMMIT— 121 次
提交当前事务现存
ENDEND— 121 次
提交当前事务现存
ROLLBACKROLLBACK— 121 次
中止当前事务现存
SAVEPOINTSAVEPOINT— —
在当前事务中定义一个新的保存点现存
SET CONSTRAINTSSETCONSTRAINTS —
为当前事务设置约束检查时机现存
COMMIT PREPAREDCOMMITPREPARED —
提交一个先前为两阶段提交而预备的事务现存
ROLLBACK PREPAREDROLLBACKPREPARED —
回滚一个先前为两阶段提交而预备的事务现存
RELEASE SAVEPOINTRELEASESAVEPOINT —
释放一个先前定义的保存点现存
ROLLBACK TO SAVEPOINTROLLBACKTO SAVEPOINT —
回滚到一个保存点现存
PREPARE TRANSACTIONPREPARETRANSACTION —
为两阶段提交准备当前事务现存
SET TRANSACTIONSETTRANSACTION —
设置当前事务的特性现存
START TRANSACTIONSTARTTRANSACTION —
开始一个事务块现存