MySQL 9.1.0
Source Code Documentation
trx_undo_ptr_t Struct Reference

The transaction handle. More...

#include <trx0trx.h>

Public Member Functions

bool is_empty ()
 
bool is_insert_only ()
 
bool is_update ()
 

Public Attributes

trx_rseg_trseg
 rollback segment assigned to the transaction, or NULL if not assigned yet More...
 
trx_undo_tinsert_undo
 pointer to the insert undo log, or NULL if no inserts performed yet More...
 
trx_undo_tupdate_undo
 pointer to the update undo log, or NULL if no update performed yet More...
 

Detailed Description

The transaction handle.

Normally, there is a 1:1 relationship between a transaction handle (trx) and a session (client connection). One session is associated with exactly one user transaction. There are some exceptions to this:

For DDL operations, a subtransaction is allocated that modifies the data dictionary tables. Lock waits and deadlocks are prevented by acquiring the dict_operation_lock before starting the subtransaction and releasing it after committing the subtransaction.

The purge system uses a special transaction that is not associated with any session.

If the system crashed or it was quickly shut down while there were transactions in the ACTIVE or PREPARED state, these transactions would no longer be associated with a session when the server is restarted.

A session may be served by at most one thread at a time. The serving thread of a session might change in some MySQL implementations. Therefore we do not have std::this_thread::get_id() assertions in the code.

Normally, only the thread that is currently associated with a running transaction may access (read and modify) the trx object, and it may do so without holding any mutex. The following are exceptions to this:

trx_rollback_resurrected() may access resurrected (connectionless) transactions while the system is already processing new user transactions. The trx_sys->mutex prevents a race condition between it and lock_trx_release_locks() [invoked by trx_commit()].

Print of transactions may access transactions not associated with the current thread. The caller must be holding trx_sys->mutex and exclusive global lock_sys latch.

When a transaction handle is in the trx_sys->mysql_trx_list or trx_sys->trx_list, some of its fields must not be modified without holding trx_sys->mutex exclusively.

The locking code (in particular, deadlock checking and implicit to explicit conversion) will access transactions associated to other connections. The locks of transactions are protected by lock_sys latches and sometimes by trx->mutex.

Killing of asynchronous transactions. Represents an instance of rollback segment along with its state variables.

Member Function Documentation

◆ is_empty()

bool trx_undo_ptr_t::is_empty ( void  )
inline
Returns
true iff no undo segment is allocated yet.

◆ is_insert_only()

bool trx_undo_ptr_t::is_insert_only ( )
inline
Returns
true iff only insert undo segment is allocated.

◆ is_update()

bool trx_undo_ptr_t::is_update ( )
inline
Returns
true iff update undo segment is allocated.

Member Data Documentation

◆ insert_undo

trx_undo_t* trx_undo_ptr_t::insert_undo

pointer to the insert undo log, or NULL if no inserts performed yet

◆ rseg

trx_rseg_t* trx_undo_ptr_t::rseg

rollback segment assigned to the transaction, or NULL if not assigned yet

◆ update_undo

trx_undo_t* trx_undo_ptr_t::update_undo

pointer to the update undo log, or NULL if no update performed yet


The documentation for this struct was generated from the following file: