This sample demostrates how to use the following properties and methods:
- The isolation property is used for setting up the transaction isolation level for the transactions managed by FireDAC.
- The auto commit property is used to control the automatic transaction management.
- The start transaction method is used to start a new DBMS transaction.
- The commit method is used to permanently store modifications made in the current transaction to the database.
- The rollback method is used to cancel all modifications made in the current transaction to the database.
Table of Contents
Location
You can find the Transactions sample project at:
- Start | Programs | Embarcadero RAD Studio Sydney | Samples and then navigate to:
Object Pascal\Database\FireDAC\Samples\Comp Layer\TFDConnection\Transactions
- Subversion Repository:
- You can find Delphi code samples in GitHub Repositories. Search by name into the samples repositories according to your RAD Studio version.
How to Use the Sample
- Navigate to the location given above and open
Transactions.dproj. - Press F9 or choose Run > Run.
- Click on the Use Connection Definition combo box and select an option.
Files
| File in Delphi | Contains |
|---|---|
Transactions.dprojTransactions.dpr | The project itself. |
fTransactions.pasfTransactions.fmx | The main form. |
Implementation
The sample implements the following database transaction features:
Setting up Transaction Isolation Level
The sample sets the Isolation property to xiReadCommitted to allow the reading of committed (permanent) changes made to the database by other simultaneous transactions. This is the default value of the Isolation property. It is set by typing the following code:
|
1 2 |
with dmlMainBase.dbMain do begin TxOptions.Isolation := xiReadCommitted; |
Controlling Auto Commit Mode
The sample turns off the AutoCommit mode by typing:
|
1 |
TxOptions.AutoCommit := <strong>False</strong>; |
Starting transaction
The sample starts a new DBMS transaction by typing:
|
1 2 3 4 |
StartTransaction; try // execute simple command inside transaction ... |
Committing Transaction
To permanently store modifications made in the current transaction to the database, call the Commit method.
|
1 2 3 4 |
... FDQuery1.ExecSQL; // Commit transaction Commit; |
Rollbacking Transaction
The sample uses the Rollback method to cancel all the current transaction modifications when an exception is raised.
|
1 2 3 4 5 6 7 8 9 10 11 12 |
StartTransaction; try // ... FDQuery1.ExecSQL; // ... // Commit transaction Commit; except // During FDQuery1.ExecSQL it's raised an exception and transaction now rollbacking Rollback; raise; end; |
Please follow the next link for more information:
http://docwiki.embarcadero.com/CodeExamples/Sydney/en/FireDAC.Transactions_Sample
Design. Code. Compile. Deploy.
Start Free Trial Upgrade Today
Free Delphi Community Edition Free C++Builder Community Edition
