#include <transaction.h>
Inheritance diagram for pqxx::Transaction:
Public Member Functions | |
Transaction (Connection &, const PGSTD::string &Name=PGSTD::string()) | |
virtual | ~Transaction () |
Use a Transaction object to enclose operations on a database in a single "unit of work." This ensures that the whole series of operations either succeeds as a whole or fails completely. In no case will it leave half finished work behind in the database.
Queries can currently only be issued through a Transaction.
Once processing on a transaction has succeeded and any changes should be allowed to become permanent in the database, call Commit(). If something has gone wrong and the changes should be forgotten, call Abort() instead. If you do neither, an implicit Abort() is executed at destruction time.
It is an error to abort a Transaction that has already been committed, or to commit a transaction that has already been aborted. Aborting an already aborted transaction or committing an already committed one has been allowed to make errors easier to deal with. Repeated aborts or commits have no effect after the first one.
Database transactions are not suitable for guarding long-running processes. If your transaction code becomes too long or too complex, please consider ways to break it up into smaller ones. There's no easy, general way to do this since application-specific considerations become important at this point.
|
Create a transaction. The optional name, if given, must begin with a letter and may contain letters and digits only. |
|
|