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

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

mysql: 连接处理程序。

type：跟踪器类型，指示要检索的信息类型。enum_session_state_type允许的跟踪器值是以下定义的枚举的成员 mysql_com.h：

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在事务开始之前设置 using 特性，如果没有事务处于活动状态，则客户端假设没有事务特性是不安全的。因此，不跟踪事务特征并在没有事务处于活动状态时切换连接是不安全的（无论这是由事务状态跟踪器还是传统 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. ________