セーブポイント
SAVEPOINT
は TiDB v6.2.0 で導入された機能です。構文は次のとおりです。
SAVEPOINT identifier
ROLLBACK TO [SAVEPOINT] identifier
RELEASE SAVEPOINT identifier
SAVEPOINT
は、現在のトランザクションに指定された名前のセーブポイントを設定するために使用されます。同名のセーブポイントがすでに存在する場合は削除され、新たに同名のセーブポイントが設定されます。ROLLBACK TO SAVEPOINT
、トランザクションを指定された名前のセーブポイントにロールバックしますが、トランザクションは終了しません。セーブポイントの後にテーブル データに加えられたデータ変更はロールバックで元に戻され、セーブポイント以降のセーブポイントはすべて削除されます。悲観的トランザクションでは、トランザクションによって保持されているロックはロールバックされません。代わりに、トランザクションが終了するとロックが解放されます。ROLLBACK TO SAVEPOINT
ステートメントで指定されたセーブポイントが存在しない場合、ステートメントは次のエラーを返します。ERROR 1305 (42000): SAVEPOINT identifier does not existRELEASE SAVEPOINT
ステートメントは、現在のトランザクションをコミットまたはロールバックせずに、指定されたセーブポイントとこのセーブポイント以降のすべてのセーブポイントを現在のトランザクションから削除します。指定された名前のセーブポイントが存在しない場合は、次のエラーが返されます。ERROR 1305 (42000): SAVEPOINT identifier does not existトランザクションがコミットまたはロールバックされると、トランザクション内のすべてのセーブポイントが削除されます。
例
テーブルt1
を作成します。
CREATE TABLE t1 (a INT NOT NULL PRIMARY KEY);
Query OK, 0 rows affected (0.12 sec)
現在のトランザクションを開始します。
BEGIN;
Query OK, 0 rows affected (0.00 sec)
テーブルにデータを挿入し、セーブポイントsp1
を設定します。
INSERT INTO t1 VALUES (1);
Query OK, 1 row affected (0.00 sec)
SAVEPOINT sp1;
Query OK, 0 rows affected (0.01 sec)
テーブルにデータを再度挿入し、セーブポイントsp2
を設定します。
INSERT INTO t1 VALUES (2);
Query OK, 1 row affected (0.00 sec)
SAVEPOINT sp2;
Query OK, 0 rows affected (0.01 sec)
セーブポイントsp2
を解放します。
RELEASE SAVEPOINT sp2;
Query OK, 0 rows affected (0.01 sec)
セーブポイントsp1
にロールバックします。
ROLLBACK TO SAVEPOINT sp1;
Query OK, 0 rows affected (0.01 sec)
トランザクションをコミットし、テーブルをクエリします。 sp1
より前に挿入されたデータのみが返されます。
COMMIT;
Query OK, 0 rows affected (0.01 sec)
SELECT * FROM t1;
+---+
| a |
+---+
| 1 |
+---+
1 row in set
MySQLの互換性
トランザクションを指定されたセーブポイントにロールバックするためにROLLBACK TO SAVEPOINT
が使用される場合、MySQL は指定されたセーブポイントの後にのみ保持されているロックを解放しますが、TiDB悲観的トランザクションでは、TiDB は指定されたセーブポイントの後に保持されているロックをすぐには解放しません。代わりに、TiDB はトランザクションがコミットまたはロールバックされるときにすべてのロックを解放します。