SAVEPOINT

Function

SAVEPOINT establishes a new savepoint within the current transaction.

A savepoint is a special mark inside a transaction. It allows all statements executed following its establishment to be rolled back, restoring the transaction state to what it was at the time of the savepoint.

Precautions

• Use ROLLBACK TO SAVEPOINT to roll back to a savepoint. Use RELEASE SAVEPOINT to destroy a savepoint but keep the effects of the statements executed after the savepoint was established.
• Savepoints can only be established when inside a transaction block. Multiple savepoints can be defined in a transaction.
• In the case of an unexpected termination of a thread or process caused by a node or connection failure, or of an error caused by the inconsistency between source and destination table structures in a COPY FROM operation, the transaction cannot be rolled back to the established savepoint. Instead, the entire transaction will be rolled back.
• According to the SQL standard, when a savepoint with the same name is created, the previous savepoint with the same name is automatically deleted. In MogDB, the old savepoint is retained, but only the latest one is used during rollback or release. Releasing the newer savepoint with RELEASE SAVEPOINT will cause the older one to again become accessible to ROLLBACK TO SAVEPOINT and RELEASE SAVEPOINT. In addition, SAVEPOINT fully complies with the SQL standard.

Syntax

Savepoint ::= SAVEPOINT savepoint_name;

Parameter Description

savepoint_name

Specifies the name of the new savepoint.

Examples

-- Create a table.
mogdb=# CREATE TABLE table1(a int);

-- Start a transaction.
mogdb=# START TRANSACTION;

-- Insert data.
mogdb=# INSERT INTO table1 VALUES (1);

-- Create a savepoint.
mogdb=# SAVEPOINT my_savepoint;

-- Insert data.
mogdb=# INSERT INTO table1 VALUES (2);

-- Roll back a savepoint.
mogdb=# ROLLBACK TO SAVEPOINT my_savepoint;

-- Insert data.
mogdb=# INSERT INTO table1 VALUES (3);

-- Commit a transaction.
mogdb=# COMMIT;

-- Query the content of the table. You can see 1 and 3 at the same time, but cannot see 2 because 2 is rolled back.
mogdb=# SELECT * FROM table1;

-- Delete the table.
mogdb=# DROP TABLE table1;

-- Create a table.
mogdb=# CREATE TABLE table2(a int);

-- Start a transaction.
mogdb=# START TRANSACTION;

-- Insert data.
mogdb=# INSERT INTO table2 VALUES (3);

-- Create a savepoint.
mogdb=# SAVEPOINT my_savepoint;

-- Insert data.
mogdb=# INSERT INTO table2 VALUES (4);

-- Roll back a savepoint.
mogdb=# RELEASE SAVEPOINT my_savepoint;

-- Commit a transaction.
mogdb=# COMMIT;

-- Query the table content. You can see 3 and 4 at the same time.
mogdb=# SELECT * FROM table2;

-- Delete a table.
mogdb=# DROP TABLE table2;

Helpful Links

RELEASE SAVEPOINT and ROLLBACK TO SAVEPOINT