MySQL session_connect_attrs 怎样读取客户端提交的连接属性
来源:17golang原创
时间:2026-11-18 14:56:04 163浏览 收藏
排查一条 MySQL 连接是由哪个客户端、哪个连接器建立时,很多人会先看进程列表,却忽略了客户端在握手阶段提交的连接属性。读取这类信息,直接查询 Performance Schema 的 session_connect_attrs 即可:它按“连接 ID + 属性名”保存全会话的键值对,常用字段是 PROCESSLIST_ID、ATTR_NAME、ATTR_VALUE 和 ORDINAL_POSITION。
官方地址:https://dev.mysql.com/doc/refman/8.4/en/performance-schema-session-connect-attrs-table.html
下面按一个实际排查场景展开:先读出一条连接的全部属性,再按属性名收窄结果,最后处理查询范围和“为什么查不到”的边界。示例只使用只读 SQL,不依赖本文环境中的运行结果。
session_connect_attrs面向所有会话;只想看当前会话账户及关联会话时,换用session_account_connect_attrs。- 一条连接通常对应多行属性,使用
PROCESSLIST_ID定位连接,再按ORDINAL_POSITION排列阅读。 - 属性由客户端和连接器决定;Performance Schema 容量不足时可能出现
_truncated属性。
一、先分清 session_connect_attrs 的范围和字段
连接属性是应用程序在建立连接时传给服务端的键值对。MySQL 8.4 手册把它们暴露在 Performance Schema 的连接属性表中,session_connect_attrs 记录所有会话,而不是只记录当前登录账号的连接。
这张表的四个字段可以按下面的方式理解:
| 字段 | 用途 | 阅读时的注意点 |
|---|---|---|
PROCESSLIST_ID | 会话连接标识 | 用于把同一连接的多行属性归到一起 |
ATTR_NAME | 属性名称 | 可能是连接器提供的名称,也可能是客户端程序自定义名称 |
ATTR_VALUE | 属性值 | 展示客户端提交的具体内容,不能假设所有连接器都有同一组属性 |
ORDINAL_POSITION | 属性加入集合时的顺序 | 适合让同一连接的属性按原顺序显示 |

属性名称并不是一份对所有客户端都完全相同的固定清单。官方文档列出的常见属性包括 _client_name、_client_version、_os、_platform 等,但实际可见集合会随平台、MySQL Connector 和客户端程序变化。名称以下划线开头的属性保留给 MySQL 内部使用,应用自定义属性时应避开这个前缀。
二、查询客户端提交的完整属性记录
最稳妥的第一条查询是把表中的字段完整取出,并先按连接 ID、再按属性加入顺序排列。这样不会因为一开始猜错属性名而漏掉信息。
-- 读取所有会话的连接属性,并让同一连接的属性集中显示
SELECT
PROCESSLIST_ID,
ATTR_NAME,
ATTR_VALUE,
ORDINAL_POSITION
FROM performance_schema.session_connect_attrs
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;
返回结果中,同一个 PROCESSLIST_ID 出现多行是正常的:每一行代表该连接提交的一项属性,而不是重复连接。若只排查某条连接,可以加上连接 ID 条件:
-- 只查看一个连接,连接编号来自 SHOW PROCESSLIST 或 performance_schema 相关表
SELECT
ATTR_NAME,
ATTR_VALUE,
ORDINAL_POSITION
FROM performance_schema.session_connect_attrs
WHERE PROCESSLIST_ID = 12345
ORDER BY ORDINAL_POSITION;
这里的 12345 是示例占位值,实际使用时替换为目标连接的 PROCESSLIST_ID。不要把它当成用户账号 ID,也不要把一条连接的多行结果压成一行后再判断属性是否存在。
三、按属性名筛选需要的连接信息
当你已经知道要找的属性名时,可以把筛选条件写在 ATTR_NAME 上。例如,很多客户端程序会提交 program_name,连接器也可能提供 _client_name 或 _client_version。查询时保留原始字段,便于区分“属性没有提交”和“值为空”。
-- 只读取常见客户端标识,仍保留连接 ID 方便回到具体会话
SELECT
PROCESSLIST_ID,
ATTR_NAME,
ATTR_VALUE,
ORDINAL_POSITION
FROM performance_schema.session_connect_attrs
WHERE ATTR_NAME IN ('program_name', '_client_name', '_client_version')
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;
如果只知道属性名的一部分,可以使用前缀匹配,但要意识到这会把多个连接器属性一起带出来:
-- 用前缀查找客户端相关属性,避免把筛选范围扩大到所有业务自定义属性
SELECT
PROCESSLIST_ID,
ATTR_NAME,
ATTR_VALUE
FROM performance_schema.session_connect_attrs
WHERE ATTR_NAME LIKE '_client%'
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;

筛选结果为空时,先确认连接是否仍然存在,再确认客户端是否真的提交了该属性。不要因为某个 Connector 没有返回 _client_version,就推断整个 session_connect_attrs 没有记录。
四、在全会话表与账户范围表之间取舍
如果排查目标是“服务器当前有哪些客户端连接”,使用 session_connect_attrs。如果排查目标只是“当前会话和同一账户关联的会话”,使用 session_account_connect_attrs,它的字段结构与前者相同,但可见范围更窄。
-- 只看当前会话账户及关联会话的连接属性
SELECT
PROCESSLIST_ID,
ATTR_NAME,
ATTR_VALUE,
ORDINAL_POSITION
FROM performance_schema.session_account_connect_attrs
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;
两张表都以 (PROCESSLIST_ID, ATTR_NAME) 为主键,并且不允许直接执行 TRUNCATE TABLE。因此,读取范围的选择应由排查目标决定:跨账号观察用全会话表,避免扩大可见范围时用账户表。
五、处理空结果和属性被截断
读取不到连接属性,通常不是 SQL 语法问题,可以按三个方向判断:
- 客户端或 Connector 没有提交你要找的属性。属性集合会随客户端、平台和 Connector 变化。
- 查询范围不对。你需要全服务器连接,却查询了
session_account_connect_attrs,或者目标连接已经断开。 - 属性总长度超过 Performance Schema 配置容量。MySQL 会截断超出容量的属性,并增加
Performance_schema_session_connect_attrs_lost计数;空间足够时还会写入_truncated属性。
可以先把截断标记也纳入读取范围:
-- 检查属性集合中是否出现服务端提供的截断标记
SELECT
PROCESSLIST_ID,
ATTR_NAME,
ATTR_VALUE,
ORDINAL_POSITION
FROM performance_schema.session_connect_attrs
WHERE ATTR_NAME = '_truncated'
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;
官方文档还说明,客户端和服务端对连接属性总大小都有固定限制,Performance Schema 另有可配置的容量限制。遇到 _truncated 时,不要把被截断的 ATTR_VALUE 当作完整客户端信息;应该结合对应 Connector 的属性定义和服务端容量设置重新判断。
小结
读取 MySQL 客户端提交的连接属性,核心就是围绕 PROCESSLIST_ID 聚合同一连接的多行记录,再用 ATTR_NAME 和 ATTR_VALUE 解释客户端身份信息。全服务器排查使用 session_connect_attrs,当前账户范围排查使用 session_account_connect_attrs;属性缺失则优先检查 Connector 来源、连接是否仍存活以及是否出现 _truncated。
相关问题
为什么同一个 PROCESSLIST_ID 会返回多行?
因为一条连接可以携带多个键值属性,表按属性名分别保存,每行对应一项属性。
session_connect_attrs 能否直接看出客户端版本?
只有在对应客户端或 Connector 提交了版本属性时才可以。应先读取实际的 ATTR_NAME,不要假设所有连接器都提供同名字段。
如何只查询当前账号能看到的连接属性?
使用 performance_schema.session_account_connect_attrs,它的范围是当前会话和同一账户关联的会话。
-
374 收藏
-
499 收藏
-
384 收藏
-
184 收藏
-
265 收藏
-
181 收藏
-
数据库 · MySQL | 1小时前 | MySQL · 主从复制 · mysql 故障转移 异步复制 Performance Schema replication_asynchronous_connection_failover167 收藏
-
数据库 · MySQL | 2小时前 | MySQL · 主从复制 · mysql Performance Schema replication_applier_global_filters 复制过滤器311 收藏
-
337 收藏
-
396 收藏
-
309 收藏
-
130 收藏
-
144 收藏
-
496 收藏
-
148 收藏
-
234 收藏
-
490 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习