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

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

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0
预发布版本文档。 PostgreSQL 19beta4 为测试版本,最终发布内容可能有所不同。

RELEASE SAVEPOINT

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

大纲

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

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

ROLLBACK;
ROLLBACK TO SAVEPOINT sp1;

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

兼容性

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

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.