128      阿裏雲  技術社區[雲棲]

MySQL InnoDB事務結構體代碼變量全攻略（附源碼）

​

InnoDB是MySQL的一個存儲引擎，支持事務，支持非堵塞的一致性讀，物理存儲結構是Page，每個事務都有回滾日誌，重做日誌，事務還會有死鎖檢測，各種各樣不同的鎖等等。

翻看InnoDB的源碼，發現數下來開啟一個事務的時候，InnoDB需要處理63個變量，變量類型紛繁複雜，結構體，自定義的數據類型等等。

這次整理，我翻看了不少同行們寫的博客，包括InnoDB官方博客，有一個心得就是不同人的翻譯不一樣，盡管是官方寫的博客，也會因為一些篇幅問題，減掉了一些細節的介紹。這次的整理，我特意保留了原來的英文備注，然後加上自己的理解進去。

MySQL的源碼文件很多，InnoDB也不少，不過我覺得事務的結構體代碼還是要理解透，透了才能理解透事務的實現細節，更加深入認識數據庫係統為了保證數據的一致性，做了多少事情....

storage/innobase/include/trx0trx.h

變量類型 ulint #define ulint unsigned long

變量類型 ib_mutex_t

mutex的代碼備注

Mutex protecting the fields state and lock (except some fields of lock, which are protected by lock_sys->mutex) Mutex保護字段的狀態和鎖定（除了某些鎖定字段，由lock_sys-> mutex保護）

ib_mutex_t對應的結構體

這裏麵又有另外一個結構體 os_event_t

變量類型 trx_state_t 變量備注

事務狀態TRX_STATE_NOT_STARTED TRX_STATE_ACTIVE TRX_STATE_PREPARED TRX_STATE_COMMITTED_IN_MEMORY (alias below COMMITTED)

結構體trx_state_t的源碼

變量類型 trx_lock_t

變量備注

Information about the transaction locks and state. Protected by trx->mutex or lock_sys->mutex or both 事務鎖和狀態有關的信息。 受trx-> mutex或lock_sys-> mutex或兩者保護。

trx_lock_t的結構體定義

變量類型 ulint 變量備注

0=normal transaction, 1=recovered, must be rolled back, protected by trx_sys->mutex when trx->in_rw_trx_list holds 0 =正常事務，1 =恢複，必須回滾，當trx-> in_rw_trx_list保持時由trx_sys-> mutex保護。

變量類型 const char*

變量類型 ulint 變量備注 READ UNCOMMITTED,READ COMMITTED,REPEATABLE READ,SERIALIZABLE

變量類型 unsigned 變量備注

MySQL has a transaction coordinator to coordinate two phase commit between multiple storage engines and the binary log. When an engine participates in a transaction, it's responsible for registering itself using the trans_register_ha() API. This flag is set to 1 after the transaction has been registered with the coordinator using the XA API, and is set to 0 after commit or rollback

MySQL有一個事務協調器來協調多個存儲引擎和二進製日誌之間的兩階段提交,它負責使用trans_register_ha（）API注冊自己。

在事務已使用XA API向協調器注冊後，此標誌設置為1，並在提交或回滾後設置為0。

變量類型 ulint

變量備注

通常為TRUE，但是如果用戶想要通過抑製對二級索引的唯一鍵檢查來加快插入，當我們決定是否可以為它們使用插入緩衝時，我們設置這個FALSE。

變量類型 ulint

變量備注 normally we do the XA two-phase commit steps, but by setting this to FALSE, one can save CPU time and about 150 bytes in the undo log size as then we skip XA steps

通常我們做XA兩階段提交步驟,但通過設置為FALSE，可以節省CPU時間和大約150字節的undo日誌大小，然後我們跳過XA步驟。

變量類型 ulint

變量備注

In 2PC, we hold the prepare_commit mutex across both phases. In that case, we defer flush of the logs to disk until after we release the mutex

在兩階段提交，我們持有兩個階段的prepare_commit互斥體。 在這種情況下，我們推遲刷新日誌到磁盤，直到我們釋放互斥體。

變量類型 ulint

變量備注

this flag is set to TRUE in trx_commit() if flush_log_later was TRUE, and there were modifications by the transaction; in that case we must flush the log in trx_commit_complete_for_mysql()

此標誌在trx_commit（）中設置為TRUE，如果flush_log_later為TRUE，並且事務進行了修改； 在這種情況下，我們必須通過trx_commit_complete_for_mysql（）刷新日誌。

變量類型 ulint

變量備注 TRX_DUP_IGNORE | TRX_DUP_REPLACE

變量類型 ulint

變量備注

TRUE if this trx has latched the search system latch in S-mode 如果此trx已在S模式下鎖定搜索係統鎖存器，則為TRUE。

變量類型 ulint

變量備注

If we notice that someone is waiting for our S-lock on the search latch to be released, we wait in row0sel.cc for BTR_SEA_TIMEOUT new searches until we try to keep the search latch again over calls from MySQL; this is intended to reduce contention on the search latch

如果我們注意到有事務在等待我們的S鎖鎖定被釋放，我們在row0sel.cc中等待BTR_SEA_TIMEOUT新的搜索，直到我們嚐試保持搜索鎖定再次超過來自MySQL的調用；這旨在減少對搜索鎖存器的爭用。

變量類型 trx_dict_op_t

變量備注

主要是三種狀態 沒有修改表結構=0 改表=1 修改索引=2

變量 ulint

備注

this is TRUE if we have declared this transaction in srv_conc_enter_innodb to be inside the InnoDB engine 如果我們已經在srv_conc_enter_innodb中聲明這個事務在InnoDB引擎中，那麼這是TRUE。

變量類型 ulint

變量備注

< this can be > 0 only when declared_to_... is TRUE; when we come to srv_conc_innodb_enter, if the value here is > 0, we decrement this by 1

<這可以> 0隻有當declared_to_be_inside_innodb _…為TRUE 當我們來到srv_conc_innodb_enter，如果這裏的值> 0，我們將其減1。

變量類型 ulint

變量備注

0, RW_S_LATCH, or RW_X_LATCH: the latch mode trx currently holds on dict_operation_lock. Protected by dict_operation_lock 0，RW_S_LATCH或RW_X_LATCH：鎖存模式trx當前持有dict_operation_lock。 受dict_operation_lock保護。

變量類型 trx_id_t

變量備注

transaction serialization number: max trx id shortly before the transaction is moved to COMMITTED_IN_MEMORY state. Protected by trx_sys_t::mutex when trx->in_rw_trx_list. Initially set to TRX_ID_MAX

事務序列號：事務被移動到COMMITTED_IN_MEMORY狀態之前不久的max trx id。 當trx-> in_rw_trx_list時，由trx_sys_t :: mutex保護。 最初設置為TRX_ID_MAX。

變量類型 time_t

變量備注 time the trx state last time became TRX_STATE_ACTIVE

trx狀態變為TRX_STATE_ACTIVE的上一次時間（開始時間）

變量類型 trx_id_t

變量備注 transaction id 事務id

變量類型 XID

sql/handler.htypedef struct xid_t XID;

xid_t是一個結構體，代碼太多，這裏就不貼了。

變量備注 X/Open XA transaction identification to identify a transaction branch 打開分布式事務的標識，以便區分事務分支。

變量類型

/* Type used for all log sequence number storage and arithmetics */

typedef ib_uint64_t     lsn_t;

變量備注

lsn at the time of the commit lsn提交的時間

變量類型 table_id_t

變量備注 Table to drop iff dict_operation == TRX_DICT_OP_TABLE, or 0。

變量類型 THD* 這是一個超級大的結構體，詳情需要看代碼。

變量備注

MySQL thread handle corresponding to this trx, or NULL 對應這個trx的MySQL線程句柄，或NULL。

變量類型 const char*

變量備注

if MySQL binlog is used, this field contains a pointer to the latest file name; this is NULL if binlog is not used

如果使用MySQL binlog，此字段包含指向最新文件名的指針; 如果不使用binlog，則為NULL。

變量類型 ib_int64_t

變量備注

if MySQL binlog is used, this field contains the end offset of the binlog entry

如果使用MySQL binlog，則此字段包含binlog條目的結束偏移量。

變量類型 ulint

變量備注 number of Innobase tables used in the processing of the current SQL statement in MySQL

MySQL中處理當前SQL語句時使用的Innobase表的數量。

變量類型 ulint

變量備注

how many tables the current SQL statement uses, except those in consistent read

變量類型 UT_LIST_NODE_T(trx_t)

變量備注

list of transactions; protected by trx_sys->mutex. The same node is used for both trx_sys_t::ro_trx_list and trx_sys_t::rw_trx_list

事務列表：受trx_sys->mutex保護。 同樣的節點用於trx_sys_t :: ro_trx_list和trx_sys_t :: rw_trx_list。

變量類型 UT_LIST_NODE_T(trx_t)

變量備注

list of transactions created for MySQL; protected by trx_sys->mutex

變量類型 dberr_t

變量備注

0 if no error, otherwise error number; NOTE That ONLY the thread doing the transaction is allowed to set this field: this is NOT protected by any mutex

錯誤碼 注意隻有執行事務的線程才允許設置此字段 這不受任何互斥保護。

變量類型 const

變量備注

if the error number indicates a duplicate key error, a pointer to the problematic index is stored here 如果錯誤號表示重複鍵錯誤，則在此存儲指向有問題索引的指針。

變量類型 ulint

變量備注

if the index creation fails to a duplicate key error, a mysql key number of that index is stored here

如果索引創建失敗，重複的鍵錯誤，該索引的mysql鍵號存儲在這裏。

變量類型 sess_t*

變量備注

session of the trx, NULL if none

變量類型que_t*

變量備注

query currently run in the session, or NULL if none; NOTE that the query belongs to the session, and it can survive over a transaction commit, if it is a stored procedure with a COMMIT WORK statement, for instance

查詢當前在運行中的會話，如果沒有則為NULL 注意，查詢屬於會話，並且它可以通過事務提交存活，如果它是具有COMMIT WORK語句的存儲過程。

變量類型 mem_heap_t*

/* A memory heap is a nonempty linear list of memory blocks */typedef mem_block_t     mem_heap_t;/* A block of a memory heap consists of the info structure

followed by an area of memory */typedef struct mem_block_info_t mem_block_t;mem_block_info_t又是一個複雜的結構體

變量備注

memory heap for the global read view 內存堆的全局讀取視圖

變量類型 read_view_t* 又是一個比較複雜的結構體

一致的讀取視圖關聯到事務或NULL

變量類型 read_view_t* 變量備注

consistent read view used in the transaction or NULL, this read view if defined can be normal read view associated to a transaction (i.e. same as global_read_view) or read view associated to a cursor

一致的讀取視圖用於事務或NULL，此讀取視圖如果定義可以是與事務相關聯的正常讀取視圖（即與global_read_view相同）或與光標相關聯的讀取視圖。

變量類型 UT_LIST_BASE_NODE_T(trx_named_savept_t)

變量備注 savepoints set with SAVEPOINT ..., oldest first 使用SAVEPOINT設置保存點的列表 ...，最舊的放在最前麵。

變量類型 ib_mutex_t

變量備注 mutex protecting the fields in this section (down to undo_no_arr), EXCEPT last_sql_stat_start, which can be accessed only when we know that there cannot be any activity in the undo logs!

互斥體保護此部分中的字段（向下到undo_no_arr），除了 last_sql_stat_start，隻有當我們知道在撤銷日誌中不能有任何活動時才可以訪問它們！

變量類型undo_no_t

/** Undo number */typedef ib_id_t undo_no_t;

變量備注

next undo log record number to assign; since the undo log is private for a transaction, this is a simple ascending sequence with no gaps; thus it represents the number of modified/inserted rows in a transaction

分配下一個撤銷日誌記錄號; 因為撤銷日誌對於事務是私有的，這是一個沒有間隙的簡單升序序列；因此它表示事務中修改/插入行的數量。

變量類型 trx_savept_t

變量備注 undo_no when the last sql statement was started: in case of an error, trx is rolled back down to this undo number; see note at undo_mutex

當最後一個SQL語句啟動時，分配undo_no：在出現錯誤的情況下，trx被回滾到這個撤銷號; 請參見undo_mutex中的注釋。

變量類型 trx_rseg_t* 這又是一個比較複雜的結構體，但segement其實是和Page綁定在一起的， 變量備注

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

回滾段分配給事務，如果尚未分配，則為NULL。

變量類型 trx_undo_t*

變量備注

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

指向插入undo日誌的指針，如果尚未執行插入，則為NULL。

變量類型 trx_undo_t*

變量備注 pointer to the update undo log, or NULL if no update performed yet

變量類型 undo_no_t

變量備注 least undo number to undo during a rollback

事務回滾的時候，最小的回滾數

變量類型 ulint

變量備注 number of undo log pages undone since the last undo log truncation

自上次撤消日誌截斷以來撤銷日誌頁麵的數量。

變量類型 trx_undo_arr_t*

變量備注 array of undo numbers of undo log records which are currently processed by a rollback operation

撤消日誌記錄的撤銷編號數組，這些撤消日誌記錄當前由回滾操作處理。

變量類型ulint

變量備注 no. of AUTO-INC rows required for an SQL statement. This is useful for multi-row INSERTs

SQL語句所需的AUTO-INC行的數量。 這對於多行INSERT非常有用。

變量類型 ib_vector_t*

變量備注

AUTOINC locks held by this transaction. Note that these are also in the lock list trx_locks. This vector needs to be freed explicitly when the trx instance is destroyed. Protected by lock_sys->mutex

此事務持有的AUTOINC鎖。 

注意，這些也在鎖定列表trx_locks中。 當trx實例被銷毀時，這個向量需要被明確地釋放。 受lock_sys-> mutex保護。

變量類型 ibool

變量備注 TRUE if transaction is flagged as a READ-ONLY transaction. if !auto_commit || will_lock > 0 then it will added to the list trx_sys_t::ro_trx_list. A read only transaction will not be assigned an UNDO log. Non-locking auto-commit read-only transaction will not be on either list

如果事務標記為READ-ONLY事務，則為TRUE。 if！auto_commit || will_lock> 0，那麼它將被添加到列表trx_sys_t :: ro_trx_list。 

隻讀事務將不會被分配UNDO日誌。 非鎖定自動提交隻讀事務將不在任一列表上。

變量類型 ibool

變量備注 TRUE if it is an autocommit

變量類型 ulint

變量備注

Will acquire some locks. Increment each time we determine that a lock will be acquired by the MySQL layer

標記會獲得一些鎖。 每次我們確定需要獲取鎖的時候，將被MySQL層獲取時遞增。

變量類型 bool

變量備注 true if it is a transaction that is being started for a DDL operation

如果它是為DDL操作啟動的事務，則為true。

變量類型 fts_trx_t*

變量類型 FTS information, or NULL if transaction hasn't modified tables with FTS indexes (yet)

FTS信息，如果事務尚未修改具有FTS索引的表（尚未），則為NULL。

變量類型 doc_id_t

變量備注

The document id used for updates 用於更新的文檔ID

變量類型 ulint

變量備注 if "covering" the FLUSH TABLES",count of tables being flushed

如果“覆蓋”FLUSH TABLES“，則表的計數被刷新。

變量類型 bool

變量備注 trx started by InnoDB API

變量類型 bool

變量備注 automatic commit

變量類型 bool

變量備注 if read and write operation

變量類型char

變量備注 detailed error message for last error, or empty

作者介紹 楊德華

• 微店高級技術專家，前阿裏集團數據庫技術團隊專家，花名應元，曾經曆過5年雙十一的數據庫大考驗。

 原文發布時間為：2017-01-05

本文來自雲棲社區合作夥伴DBAplus

最後更新：2017-05-13 08:43:44

  上一篇：  容器就像監獄，讓我們來構造一個監獄吧！(含代碼下載)

  下一篇：  facebook\微博 like場景 數據庫設計與性能壓測