SAVEPOINT

【置顶】

SAVEPOINT（存点）

savepoint-stmt: 隐藏

release-stmt: 隐藏

rollback-stmt: 隐藏

SAVEPOINTs 是一种创建事务的方法，类似于 BEGIN 和 COMMIT ，但不同的是 SAVEPOINT 和 RELEASE 命令是可命名的并且可以嵌套。

SAVEPOINT 命令启动一个带名称的新事务，其名称不必是唯一的。SAVEPOINT 可以在 BEGIN ... COMMIT 之内或之外启动。当 SAVEPOINT 是最外面的保存点并且它不在 BEGIN ... COMMIT 内时，那么这个命令与 BEGIN DEFERRED TRANSACTION 等效。

ROLLBACK TO 命令将数据库的状态恢复为在相应的 SAVEPOINT 之后的状态。请注意，与那个普通的 ROLLBACK 命令（没有 TO 关键字）不同， ROLLBACK TO 命令不会取消事务，而是在开始时重新启动事务，但所有介入的 SAVEPOINT 都被取消。

RELEASE 命令就像 SAVEPOINT 的 COMMIT 一样，它可导致所有保存点返回（包括具有匹配名称的最近保存点），以便从事务堆栈中删除。内部事务的 RELEASE 不会将任何更改写入数据库文件; 它只是从事务堆栈中删除保存点，使之不能对这些保存点进行 ROLLBACK TO 操作。如果 RELEASE 释放最外层的保存点，使事务堆栈变为空，则此时 RELEASE 与 COMMIT 的作用相同。即使事务最初由 SAVEPOINT 而不是 BEGIN 启动， COMMIT 也可用于释放所有保存点并提交事务。

如果 RELEASE 命令中的 savepoint-name 与当前在事务堆栈中的任何保存点不匹配，则不会释放保存点，数据库保持不变，并且 RELEASE 命令返回错误值。

请注意，内部事务可能会被提交（使用 RELEASE 命令），但随后在外部事务中可通过 ROLLBACK 取消其工作。电源故障、程序崩溃或操作系统崩溃将导致最外层事务回落，同时撤消在该外层事务中发生的所有更改（甚至是 RELEASE 命令应该“提交”的更改）。在最外层事务提交之前，内容实际上并未在磁盘上提交。

以下是几种关于RELEASE命令的讨论：

• 有些人认为 RELEASE 等同于 SAVEPOINT 的 COMMIT 。这是可以接受的观点，前提是内部事务提交的更改之后可以通过外部事务中的回落进行撤销。

• 对于 RELEASE 的另一个观点是，它将一个命名事务合并到它的父事务中，以便两者代变成同一事务。在执行 RELEASE 命令之后，无论命名事务是什么，它及其父母都会一起提交或回落。

• 一些人也将交易时间表中的保存点视为“标记”。在这个观点中， SAVEPOINT 命令创建一个新标记， ROLLBACK TO 命令将时间线回退到紧接着该标记后的下一个点， RELEASE 命令擦除时间线中的标记，但实质上而不对数据库进行任何更改。

事务嵌套规则

最后一个事务开始时，第一个事务将提交或回落

BEGIN 命令仅适用于事务堆栈为空的情况，也就是没有未决事务的情况。如果在调用 BEGIN 时事务堆栈不为空，那么该命令会失败并显示错误信息。

COMMIT 命令提交所有未完成的事务，并将事务堆栈清空。

RELEASE 命令从事务堆栈中最新添加的事务开始，及时向后释放保存点，直到它释放具有匹配保存点名称的保存点为止。而之前的保存点，即使是具有匹配保存点名称的保存点也不会改变。如果 RELEASE 命令导致事务堆栈变空（即 RELEASE 命令在堆栈中释放最外层的事务），则事务被提交。

没有 ”TO“ 子句的 ROLLBACK 命令将回退所有事务，并使事务堆保持空闲。

带有 TO 子句的 ROLLBACK 命令会及时回退事务，并返回到具有匹配名称的最新 SAVEPOINT 。具有匹配名称的 SAVEPOINT 保留在事务堆栈上，但是在创建 SAVEPOINT 后发生的所有数据库更改都会回退。如果 ROLLBACK TO 命令中的 savepoint-name 与堆栈中的任何 SAVEPOINT 都不匹配，则ROLLBACK命令将失败并显示错误，并保持数据库状态不变。

 SQLite is in the Public Domain.