SAVEPOINT savepoint_name

描述

SAVEPOINT在当前事务中建立一个新的保存点。

保存点是事务中的一种特殊标记，它允许回滚在其建立之后执行的所有命令， 从而将事务状态恢复到建立保存点时的状态。

参数

注解

使用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。

另见

BEGIN, COMMIT, RELEASE SAVEPOINT, ROLLBACK, ROLLBACK TO SAVEPOINT