COMMIT

The COMMIT statement commits the current transaction or, when using client-side transaction retries, clears the connection to allow new transactions to begin.

When using client-side transaction retries, statements issued after SAVEPOINT are committed when RELEASE SAVEPOINT is issued instead of COMMIT. However, you must still issue a COMMIT statement to clear the connection for the next transaction.

For non-retryable transactions, if statements in the transaction generated any errors, COMMIT is equivalent to ROLLBACK, which aborts the transaction and discards all updates made by its statements.

Synopsis

COMMITENDTRANSACTION

Required privileges

No privileges are required to commit a transaction. However, privileges are required for each statement within a transaction.

Aliases

In CockroachDB, END is an alias for the COMMIT statement.

Example

Commit a transaction

How you commit transactions depends on how your application handles transaction retries.

Client-side retryable transactions

When using client-side transaction retries, statements are committed by RELEASE SAVEPOINT. COMMIT itself only clears the connection for the next transaction.

  1. > BEGIN;
  1. > SAVEPOINT cockroach_restart;
  1. > UPDATE products SET inventory = 0 WHERE sku = '8675309';
  1. > INSERT INTO orders (customer, sku, status) VALUES (1001, '8675309', 'new');
  1. > RELEASE SAVEPOINT cockroach_restart;
  1. > COMMIT;

Warning:
This example assumes you're using client-side intervention to handle transaction retries.

Automatically retried transactions

If you are using transactions that CockroachDB will automatically retry (i.e., all statements sent in a single batch), commit the transaction with COMMIT.

  1. > BEGIN; UPDATE products SET inventory = 100 WHERE = '8675309'; UPDATE products SET inventory = 100 WHERE = '8675310'; COMMIT;

See also

Was this page helpful?
YesNo