支持的版本:当前 (17) / 16 / 15 / 14 / 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

SAVEPOINT

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

概要

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 the second savepoint
    ROLLBACK TO SAVEPOINT my_savepoint;
    SELECT * FROM table1;               -- shows rows 1 and 2

    -- release the second savepoint
    RELEASE SAVEPOINT my_savepoint;

    -- rollback to the first savepoint
    ROLLBACK TO SAVEPOINT my_savepoint;
    SELECT * FROM table1;               -- shows only row 1
COMMIT;

上面的事务显示先回滚第 3 行,然后回滚第 2 行。

兼容性

SQL 要求当建立另一个同名保存点时,自动销毁保存点。在 PostgreSQL 中,旧的保存点会被保留,但回滚或释放时只会使用较新的保存点。(使用 RELEASE SAVEPOINT 释放较新的保存点将导致较旧的保存点再次可以通过 ROLLBACK TO SAVEPOINTRELEASE SAVEPOINT 访问。)除此之外,SAVEPOINT 完全符合 SQL 标准。

提交更正

如果您发现文档中有任何不正确、与您使用特定功能的体验不符或需要进一步澄清的地方,请使用此表单报告文档问题。