SAVEPOINT savepoint_name

说明

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 中，旧保存点将保留，但在回滚或释放时只会使用较新的保存点。（使用 释放保存点 释放较新的保存点将导致旧保存点再次变为 回滚到保存点 和 释放保存点 访问。）除此之外，保存点 完全符合 SQL。

另请参见

BEGIN、COMMIT、释放保存点、回滚、回滚到保存点