SHOW SAVEPOINT STATUS

On this page Carat arrow pointing down
Warning:
GA releases for CockroachDB v23.1 are no longer supported. Cockroach Labs will stop providing LTS Assistance Support for v23.1 LTS releases on November 13, 2025. Prior to that date, upgrade to a more recent version to continue receiving support. For more details, refer to the Release Support Policy.

The SHOW SAVEPOINT STATUS statement lists the active savepoints in the current transaction.

Required privileges

No privileges are required to create or show a savepoint. However, privileges are required for each statement within a transaction.

Synopsis

SHOW SAVEPOINT STATUS

Response

The following fields are returned for each savepoint.

Field Description
savepoint_name The name of the savepoint.
is_initial_savepoint Whether the savepoint is the outermost savepoint in the transaction.

Example

  1. Open a transaction using BEGIN, and create a nested transaction using a savepoint:

    icon/buttons/copy
    > BEGIN;
    SAVEPOINT foo;
    
  2. Use the SHOW SAVEPOINT STATUS statement to list the active savepoints in the current nested transaction.

    icon/buttons/copy
    > SHOW SAVEPOINT STATUS;
    
      savepoint_name | is_initial_savepoint
    -----------------+-----------------------
      foo            |        true
    (1 row)
    

    Currently, there is only one savepoint.

  3. Commit this nested transaction by issuing the RELEASE SAVEPOINT statement, then clear the connection for the next transaction by issuing a COMMIT statement:

    icon/buttons/copy
    > RELEASE SAVEPOINT foo;
    COMMIT;
    

    If we did not want to commit this nested transaction, but restart it instead, we would have issued a ROLLBACK TO SAVEPOINT.

See also


Yes No
On this page

Yes No