Contents Index COMMENT statement CONFIGURE statement [Interactive SQL]

ASA SQL Reference
  SQL Statements

COMMIT statement


Description 

Use this statement to make changes to the database permanent, or to terminate a user-defined transaction.

Syntax 1 

COMMIT [ WORK ]

Syntax 2 

COMMIT TRAN[SACTION] [ transaction-name ]

Parameters 

transaction-name    An optional name assigned to this transaction. It must be a valid identifier. You should use transaction names only on the outermost pair of nested BEGIN/COMMIT or BEGIN/ROLLBACK statements.

For more information on transaction nesting in Adaptive Server Enterprise and Adaptive Server Anywhere, see BEGIN TRANSACTION statement. For more information on savepoints, see SAVEPOINT statement.

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

Usage 

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

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

The COMMIT statement 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, the COMMIT TRANSACTION statement decreases the nesting level of transactions by one. When transactions are nested, only the outermost COMMIT makes the changes to the database permanent.

Permissions 

None.

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..

See also 

BEGIN TRANSACTION statement

PREPARE TO COMMIT statement

ROLLBACK statement

Standards and compatibility 
Example 

The following statement commits the current transaction:

COMMIT

The following Transact-SQL batch reports successive values of @@trancount as 0, 1, 2, 1, 0.

PRINT @@trancount
BEGIN TRANSACTION
PRINT @@trancount
BEGIN TRANSACTION
PRINT @@trancount
COMMIT TRANSACTION
PRINT @@trancount
COMMIT TRANSACTION
PRINT @@trancount
go

Contents Index COMMENT statement CONFIGURE statement [Interactive SQL]