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

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

百科 / SQL 命令 / 事务控制

SQL COMMAND · 事务控制

SAVEPOINT

在当前事务中定义一个新的保存点

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

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

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

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

SAVEPOINT savepoint_name

语法概要

SAVEPOINT savepoint_name

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

描述

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。

另见

语法演化

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

  1. PostgreSQL 14← 13正文更新

    正文更新

同组命令

命令动词对象版本变动最近变更
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 —
开始一个事务块现存