mysql_session_track_get_first() 提取從伺服器接收到的狀態變更資訊的第一部分。

mysql_session_track_get_next() 提取從伺服器接收到的任何剩餘狀態變更資訊。在成功呼叫 mysql_session_track_get_first() 之後，只要此函數傳回成功，就重複呼叫此函數。

mysql：連線處理常式。

type：追蹤器類型，指出要擷取哪種資訊。允許的追蹤器值是在 mysql_com.h 中定義的 enum_session_state_type 列舉的成員。

enum enum_session_state_type
{
  SESSION_TRACK_SYSTEM_VARIABLES,            /* Session system variables */
  SESSION_TRACK_SCHEMA,                      /* Current schema */
  SESSION_TRACK_STATE_CHANGE,                /* Session state changes */
  SESSION_TRACK_GTIDS,                       /* GTIDs */
  SESSION_TRACK_TRANSACTION_CHARACTERISTICS, /* Transaction characteristics */
  SESSION_TRACK_TRANSACTION_STATE            /* Transaction state */
};

隨著 MySQL 實作額外的會話資訊追蹤器，該列舉的成員可能會隨著時間而變更。為了方便應用程式循環遍歷所有可能的追蹤器類型，而不考慮成員的數量，SESSION_TRACK_BEGIN 和 SESSION_TRACK_END 符號定義為等於 enum_session_state_type 列舉的第一個和最後一個成員。本節稍後顯示的範例程式碼將示範此技術。(當然，如果列舉成員變更，您必須重新編譯您的應用程式，使其能夠考慮新的追蹤器。)

data：const char * 變數的位址。成功呼叫後，此變數會指向傳回的資料，該資料應視為唯讀。

length：size_t 變數的位址。成功呼叫後，此變數會包含由 data 參數指向的資料長度。

SESSION_TRACK_SCHEMA：此追蹤器類型表示已設定預設結構描述。data 是一個包含新預設結構描述名稱的字串。length 是字串長度。

若要啟用此追蹤器類型的通知，請啟用 session_track_schema 系統變數。

SESSION_TRACK_SYSTEM_VARIABLES：此追蹤器類型表示已將一個或多個追蹤的會話系統變數指派一個值。當指派會話系統變數時，每個變數會傳回兩個值 (在個別的呼叫中)。對於第一次呼叫，data 是一個包含變數名稱的字串，而 length 是字串長度。對於第二次呼叫，data 是一個包含變數值的字串，而 length 是字串長度。

預設情況下，會針對這些會話系統變數啟用通知

若要變更此追蹤器類型的預設通知，請將 session_track_schema 系統變數設定為要追蹤變更的逗號分隔變數清單，或設定為 * 以追蹤所有變數的變更。若要停用會話變數指派的通知，請將 session_track_system_variables 設定為空字串。

SESSION_TRACK_STATE_CHANGE：此追蹤器類型表示會話狀態的某些追蹤屬性發生了變更。data 是一個位元組，其中包含一個布林旗標，指出是否發生了會話狀態變更。length 應為 1。旗標表示為 ASCII 值，而不是二進位值 (例如，'1'，而不是 0x01)。

若要啟用此追蹤器類型的通知，請啟用 session_track_state_change 系統變數。

此追蹤器會報告會話狀態的這些屬性的變更

SESSION_TRACK_GTIDS：此追蹤器類型表示 GTID 可用。data 包含 GTID 字串。length 是字串長度。GTID 字串採用用於指定一組 GTID 值的標準格式；請參閱GTID 集合。

若要啟用此追蹤器類型的通知，請設定 session_track_gtids 系統變數。

SESSION_TRACK_TRANSACTION_CHARACTERISTICS：此追蹤器類型表示交易特性可用。data 是一個包含特性資料的字串。length 是字串長度。特性追蹤器資料字串可以是空的，也可以包含一個或多個 SQL 陳述式，每個陳述式都以分號結尾

若要啟用此追蹤器類型的通知，請將 session_track_transaction_info 系統變數設定為 CHARACTERISTICS（這也會啟用 SESSION_TRACK_TRANSACTION_STATE 追蹤器類型）。

交易特性追蹤使客戶端能夠確定如何在另一個會話中重新啟動交易，使其具有與原始會話相同的特性。

由於特性可能會在使用 SET TRANSACTION 啟動交易之前設定，因此如果沒有活動交易，客戶端假設沒有交易特性是不安全的。因此，不追蹤交易特性，而僅在沒有活動交易時切換連線（無論是通過交易狀態追蹤器還是傳統的 SERVER_STATUS_IN_TRANS 標誌檢測到），都是不安全的。如果客戶端可能希望在某個時刻將其會話切換到另一個連線，並且可能會使用交易，則 必須 訂閱交易特性追蹤器。

特性追蹤器追蹤僅適用於下一個交易的一次性特性的變更。它不追蹤會話變數的變更。因此，客戶端還必須追蹤 transaction_isolation 和 transaction_read_only 系統變數，以正確確定當下一個交易特性值為空時適用的會話預設值。（要追蹤這些變數，請在 session_track_system_variables 系統變數的值中列出它們。）

SESSION_TRACK_TRANSACTION_STATE：此追蹤器類型表示交易狀態資訊可用。data 是一個包含 ASCII 字元的字串，每個字元都表示交易狀態的某些方面。length 是字串長度（始終為 8）。

若要啟用此追蹤器類型的通知，請將 session_track_transaction_info 系統變數設定為 STATE。

交易狀態追蹤使客戶端能夠確定交易是否正在進行中，以及是否可以在不回滾的情況下將其移動到另一個會話。

追蹤器項目的範圍是交易。所有表示狀態的標誌都會持續存在，直到交易提交或回滾。當語句添加到交易中時，可能會在連續的追蹤器資料值中設定其他標誌。但是，在交易結束之前，不會清除任何標誌。

交易狀態報告為包含一系列 ASCII 字元的字串。每個活動狀態都有一個唯一的字元分配給它，以及在序列中的固定位置。以下列表描述了序列的第 1 到第 8 個位置允許的值

考慮一個包含以下語句的會話，包括啟用交易狀態追蹤器的語句

1. SET @@SESSION.session_track_transaction_info='STATE';
2. START TRANSACTION;
3. SELECT 1;
4. INSERT INTO t1 () VALUES();
5. INSERT INTO t1 () VALUES(1, RAND());
6. COMMIT;

啟用交易狀態追蹤後，以下 data 值會從這些語句產生

1. ________
2. T_______
3. T_____S_
4. T___W_S_
5. T___WsS_
6. ________