选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.3 已于 2018 年 11 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

SAVEPOINT

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

大纲

SAVEPOINT savepoint_name

描述

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

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

参数

savepoint_name

赋予新保存点的名称。

注解

使用ROLLBACK TO SAVEPOINT回滚到保存点。使用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。

兼容性

SQL 要求在建立另一个同名保存点时自动销毁原有保存点。在 PostgreSQL中,旧保存点会被保留,不过在回滚或 释放时只会使用最近建立的那个。(如果使用 RELEASE SAVEPOINT释放较新的保存点,较旧的保存点将再次 可供 ROLLBACK TO SAVEPOINTRELEASE SAVEPOINT 使用。)除此之外, SAVEPOINT 完全符合 SQL。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。