选择 打开 改范围 完整检索页

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))); -- 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允许省略它。

另见

语法演化

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

  1. PostgreSQL 14← 13正文更新

    正文更新

同组命令

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