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 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 SAVEPOINT 和 RELEASE SAVEPOINT。）除此之外，SAVEPOINT 完全符合 SQL 标准。

另请参阅

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