Documentation Home
MySQL 8.3 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.8Mb
PDF (A4) - 40.9Mb
Man Pages (TGZ) - 294.0Kb
Man Pages (Zip) - 409.0Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb
Excerpts from this Manual

MySQL 8.3 Reference Manual  /  ...  /  Server Tracking of Client Session State

7.1.18 服务器跟踪客户端会话状态

MySQL 服务器实现了多个会话状态跟踪器。客户端可以启用这些跟踪器以接收会话状态更改的通知。

会话状态跟踪器的用途

会话状态跟踪器有以下用途:

  • 促进会话迁移。

  • 促进事务切换。

跟踪器机制为 MySQL 连接器和客户端应用程序提供了一种检测会话上下文是否可用的手段,以便在负载均衡环境中决定是否可以进行会话切换。

跟踪器机制允许应用程序知道何时可以将事务从一个会话移到另一个会话。事务状态跟踪使得这成为可能,这对希望将事务从繁忙服务器移到较少负载的服务器的应用程序非常有用。例如,负载均衡连接器管理客户端连接池可以在池中的可用会话之间移动事务。

然而,会话切换不能在任意时间进行。如果会话正在进行事务,并且已经执行了读取或写入操作,那么切换到另一个会话将意味着原始会话的事务回滚。会话切换只能在事务没有执行任何读取或写入操作时进行。

以下是事务可能合理地被切换的时刻:

除了知道事务状态外,还需要知道事务特征,以便在将事务移到另一个会话时使用相同的特征。以下特征对此目的非常重要:

READ ONLY
READ WRITE
ISOLATION LEVEL
WITH CONSISTENT SNAPSHOT

可用的会话状态跟踪器

为了支持会话跟踪活动,以下类型的客户端会话状态信息的通知是可用的:

有关跟踪器相关系统变量的描述,请参阅第 7.1.8 节,“服务器系统变量”。这些系统变量允许控制哪些更改通知发生,但不提供访问通知信息的方式。通知发生在 MySQL 客户端/服务器协议中,以便会话状态更改可以被检测到。

C API 会话状态跟踪器支持

为了使客户端应用程序能够从服务器返回的 OK 包中提取状态更改信息,MySQL C API 提供了一对函数:

测试套件会话状态跟踪器支持

程序 mysqltest 具有 disable_session_track_infoenable_session_track_info 命令,控制会话跟踪器通知是否发生。你可以使用这些命令从命令行查看 SQL 语句生成的通知。假设文件 testscript 包含以下 mysqltest 脚本:

DROP TABLE IF EXISTS test.t1;
CREATE TABLE test.t1 (i INT, f FLOAT);
--enable_session_track_info
SET @@SESSION.session_track_schema=ON;
SET @@SESSION.session_track_system_variables='*';
SET @@SESSION.session_track_state_change=ON;
USE information_schema;
SET NAMES 'utf8mb4';
SET @@SESSION.session_track_transaction_info='CHARACTERISTICS';
SET TRANSACTION ISOLATION LEVEL SERIALIZABLE;
SET TRANSACTION READ WRITE;
START TRANSACTION;
SELECT 1;
INSERT INTO test.t1 () VALUES();
INSERT INTO test.t1 () VALUES(1, RAND());
COMMIT;

运行脚本以查看启用跟踪器提供的信息。有关 mysqltest 显示的各种跟踪器的 Tracker: 信息的描述,请参阅 mysql_session_track_get_first()

$> mysqltest < testscript
DROP TABLE IF EXISTS test.t1;
CREATE TABLE test.t1 (i INT, f FLOAT);
SET @@SESSION.session_track_schema=ON;
SET @@SESSION.session_track_system_variables='*';
-- Tracker : SESSION_TRACK_SYSTEM_VARIABLES
-- session_track_system_variables
-- *

SET @@SESSION.session_track_state_change=ON;
-- Tracker : SESSION_TRACK_SYSTEM_VARIABLES
-- session_track_state_change
-- ON

USE information_schema;
-- Tracker : SESSION_TRACK_SCHEMA
-- information_schema

-- Tracker : SESSION_TRACK_STATE_CHANGE
-- 1

SET NAMES 'utf8mb4';
-- Tracker : SESSION_TRACK_SYSTEM_VARIABLES
-- character_set_client
-- utf8mb4
-- character_set_connection
-- utf8mb4
-- character_set_results
-- utf8mb4

-- Tracker : SESSION_TRACK_STATE_CHANGE
-- 1

SET @@SESSION.session_track_transaction_info='CHARACTERISTICS';
-- Tracker : SESSION_TRACK_SYSTEM_VARIABLES
-- session_track_transaction_info
-- CHARACTERISTICS

-- Tracker : SESSION_TRACK_STATE_CHANGE
-- 1

-- Tracker : SESSION_TRACK_TRANSACTION_CHARACTERISTICS
--

-- Tracker : SESSION_TRACK_TRANSACTION_STATE
-- ________

SET TRANSACTION ISOLATION LEVEL SERIALIZABLE;
-- Tracker : SESSION_TRACK_TRANSACTION_CHARACTERISTICS
-- SET TRANSACTION ISOLATION LEVEL SERIALIZABLE;

SET TRANSACTION READ WRITE;
-- Tracker : SESSION_TRACK_TRANSACTION_CHARACTERISTICS
-- SET TRANSACTION ISOLATION LEVEL SERIALIZABLE; SET TRANSACTION READ WRITE;

START TRANSACTION;
-- Tracker : SESSION_TRACK_TRANSACTION_CHARACTERISTICS
-- SET TRANSACTION ISOLATION LEVEL SERIALIZABLE; START TRANSACTION READ WRITE;

-- Tracker : SESSION_TRACK_TRANSACTION_STATE
-- T_______

SELECT 1;
1
1
-- Tracker : SESSION_TRACK_TRANSACTION_STATE
-- T_____S_

INSERT INTO test.t1 () VALUES();
-- Tracker : SESSION_TRACK_TRANSACTION_STATE
-- T___W_S_

INSERT INTO test.t1 () VALUES(1, RAND());
-- Tracker : SESSION_TRACK_TRANSACTION_STATE
-- T___WsS_

COMMIT;
-- Tracker : SESSION_TRACK_TRANSACTION_CHARACTERISTICS
--

-- Tracker : SESSION_TRACK_TRANSACTION_STATE
-- ________

ok

START TRANSACTION 语句之前,两个 SET TRANSACTION 语句执行,设置下一个事务的隔离级别和访问模式特征。SESSION_TRACK_TRANSACTION_CHARACTERISTICS 值指示了这些下一个事务值已经被设置。

COMMIT 语句结束事务后,SESSION_TRACK_TRANSACTION_CHARACTERISTICS 值被报告为空。这表明在事务开始之前设置的下一个事务特征已经被重置,并且会话默认值适用。要跟踪这些会话默认值的更改,请跟踪 transaction_isolationtransaction_read_only 系统变量的会话值。

要查看 GTIDs 的信息,请使用 session_track_gtids 系统变量启用 SESSION_TRACK_GTIDS 跟踪器。