COMMIT statement

Description

Makes changes to the database permanent, or terminates a user-defined transaction.

Syntax

Syntax 1

COMMIT [ WORK ]

Syntax 2

COMMIT TRAN[SACTION ] [transaction-name ]

Examples

Example 1

Usage

Syntax 1 The COMMIT statement ends a transaction and makes all changes made during this transaction permanent in the database.

Data definition statements carry out commits automatically. For information, see the Side effects listing for each SQL statement.

COMMIT fails if the database server detects any invalid foreign keys. This makes it impossible to end a transaction with any invalid foreign keys. Usually, foreign key integrity is checked on each data manipulation operation. However, if the database option WAIT_FOR_COMMIT is set ON or a particular foreign key was defined with a CHECK ON COMMIT clause, the database server delays integrity checking until the COMMIT statement is executed.

Syntax 2 You can use BEGIN TRANSACTION and COMMIT TRANSACTION statements in pairs to construct nested transactions. Nested transactions are similar to savepoints. When executed as the outermost of a set of nested transactions, the statement makes changes to the database permanent. When executed inside a transaction, COMMIT TRANSACTION decreases the nesting level of transactions by one. When transactions are nested, only the outermost COMMIT makes the changes to the database permanent.

The optional parameter transaction-name is the name assigned to this transaction. It must be a valid identifier. Use transaction names only on the outermost pair of nested BEGIN/COMMIT or BEGIN/ROLLBACK statements.

You can use a set of options to control the detailed behavior of the COMMIT statement. For information, see “COOPERATIVE_COMMIT_TIMEOUT option”, “COOPERATIVE_COMMITS option”, “DELAYED_COMMITS option”, and “DELAYED_COMMIT_TIMEOUT option”. You can use the Commit connection property to return the number of commits on the current connection.


Side effects

Closes all cursors except those opened WITH HOLD.

Deletes all rows of declared temporary tables on this connection, unless they were declared using ON COMMIT PRESERVE ROWS.

Standards

Permissions

Must be connected to the database.

See also

BEGIN TRANSACTION statement

CONNECT statement [ESQL] [DBISQL]

DISCONNECT statement [DBISQL]

ROLLBACK statement

SAVEPOINT statement

SET CONNECTION statement [DBISQL] [ESQL]