PostgreSQL 教程

Appearance

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 SAVEPOINT和RELEASE SAVEPOINT使用。）否则，SAVEPOINT完全符合 SQL。

另请参见 ​

BEGIN、COMMIT、RELEASE SAVEPOINT、ROLLBACK、ROLLBACK TO SAVEPOINT