mysql_session_track_get_first ()获取从服务器接收的状态更改信息的第一部分。

mysql_session_track_get_next ()获取从服务器接收到的任何剩余状态更改信息。成功调用后mysql_session_track_get_first ()，只要返回成功，就重复调用此函数。

mysql:连接处理程序。

类型:指示要检索的信息类型的跟踪器类型。控件的成员是允许的跟踪器值enum_session_state_type枚举中定义mysql_com.h：

enum枚举session_state_type {SESSION_TRACK_SYSTEM_VARIABLES， /*会话系统变量*/ SESSION_TRACK_SCHEMA， /*当前模式*/ SESSION_TRACK_STATE_CHANGE， /*会话状态变化*/ SESSION_TRACK_GTIDS， /* GTIDs */ SESSION_TRACK_TRANSACTION_CHARACTERISTICS， /*事务特征*/ SESSION_TRACK_TRANSACTION_STATE /*事务状态*/};

当MySQL实现额外的会话信息跟踪器时，该枚举的成员可能会随着时间而改变。为了使应用程序能够轻松地遍历所有可能的跟踪器类型，而不管成员的数量SESSION_TRACK_BEGIN而且SESSION_TRACK_END类的第一个和最后一个成员被定义为等于enum_session_state_type枚举。本节后面显示的示例代码演示了这种技术。(当然，如果枚举成员发生变化，则必须重新编译应用程序，使其能够考虑到新的跟踪器。)

数据: a的地址const char *变量。在一个成功的调用之后，这个变量指向返回的数据，应该被认为是只读的。

长度: a的地址size_t变量。方法所指向的数据的长度数据参数。

SESSION_TRACK_SCHEMA:此跟踪器类型表示已设置默认模式。数据包含新的默认模式名称的字符串。长度是字符串长度。

要启用此跟踪器类型的通知，请启用session_track_schema系统变量。

SESSION_TRACK_SYSTEM_VARIABLES:此跟踪器类型表示已为一个或多个跟踪会话系统变量分配了值。当分配会话系统变量时，每个变量返回两个值(在单独的调用中)。第一个电话，数据是否包含变量名和长度是字符串长度。第二通电话，数据是否包含变量值和长度是字符串长度。

默认情况下，这些会话系统变量启用了通知:

若要更改此跟踪器类型的默认通知，请设置session_track_schema系统变量转换为要跟踪更改的以逗号分隔的变量列表，或＊跟踪所有变量的变化。若要禁用会话变量分配的通知，请设置session_track_system_variables到空字符串。

SESSION_TRACK_STATE_CHANGE:此跟踪器类型表示对会话状态的某些跟踪属性的更改。数据一个字节，它包含一个布尔标志，指示是否发生了会话状态更改。长度应该是1。该标志表示为ASCII值，而不是二进制值(例如，' 1 ',而不是0 x01)．

要启用此跟踪器类型的通知，请启用session_track_state_change系统变量。

这个跟踪器报告会话状态的这些属性的变化:

SESSION_TRACK_GTIDS:此跟踪器类型表示gtid可用。数据包含GTID字符串。长度是字符串长度。GTID字符串是用于指定一组GTID值的标准格式;看到GTID集．

要启用此跟踪器类型的通知，请设置session_track_gtids系统变量。

SESSION_TRACK_TRANSACTION_CHARACTERISTICS:此跟踪器类型表示事务特征可用。数据包含特征数据的字符串。长度是字符串长度。特征跟踪器数据字符串可以为空，也可以包含一个或多个SQL语句，每个语句以分号结束:

要启用此跟踪器类型的通知，请设置session_track_transaction_info系统变量特征(这也启用了SESSION_TRACK_TRANSACTION_STATE跟踪类型)。

事务特征跟踪使客户端能够确定如何在另一个会话中重新启动事务，使其具有与原始会话相同的特征。

因为特征可以设置使用设置事务在事务启动之前，如果没有活动的事务，那么客户机认为没有事务特征是不安全的。因此，不跟踪事务特征而在没有事务活动时切换连接是不安全的(无论这是由事务状态跟踪器还是传统的SERVER_STATUS_IN_TRANS国旗)。一个客户端必须如果事务特性跟踪器希望在某个时刻将其会话切换到另一个连接，就可以使用事务，那么可以订阅事务特性跟踪器。

特征跟踪器跟踪仅应用于下一个事务的一次性特征的更改。它不跟踪对会话变量的更改。因此，客户端还必须跟踪transaction_isolation而且transaction_read_only正确确定下一个事务特征值为空时应用的会话默认值的系统变量。的值中列出这些变量session_track_system_variables系统变量)。

SESSION_TRACK_TRANSACTION_STATE:此跟踪器类型表示事务状态信息可用。数据是一个包含ASCII字符的字符串，每个字符表示事务状态的某个方面。长度字符串长度(总是8)。

要启用此跟踪器类型的通知，请设置session_track_transaction_info系统变量状态．

事务状态跟踪使客户机能够确定事务是否在进行中，以及是否可以将其移动到不同的会话而不回滚。

跟踪项的范围是事务。所有状态指示标志都将持续存在，直到事务提交或回滚。当语句被添加到事务中时，可以在后续的跟踪器数据值中设置附加标志。但是，在事务结束之前，不会清除任何标志。

事务状态报告为一个包含ASCII字符序列的字符串。每个活动状态都有分配给它的唯一字符以及序列中的固定位置。下面的列表描述了序列中位置1到8的允许值:

考虑一个由以下语句组成的会话，包括一个启用事务状态跟踪器的语句:

1.设置@@SESSION.session_track_transaction_info =“状态”;2.开始事务;3.选择1;4.INSERT INTO t1 () VALUES();5.INSERT INTO t1 () VALUES(1, RAND()); 6. COMMIT;

启用事务状态跟踪后，将执行以下操作数据值由这些语句产生:

1.在2。T_______ 3。T_____S_ 4。T___W_S_ 5。T___WsS_ 6。＿＿＿＿＿＿＿＿