MySQL session_connect_attrs 怎样读取客户端提交的连接属性
排查一条 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,它的范围是当前会话和同一账户关联的会话。
快递运单保价 怎样区分声明价值与实际物品价值
- 上一篇
- 快递运单保价 怎样区分声明价值与实际物品价值
- 下一篇
- Redis FUNCTION LIST WITHCODE 怎样同时查看函数库信息与代码
-
- 数据库 · MySQL | 3小时前 | MySQL · mysql 空间数据 LineString ST_PointN
- MySQL ST_PointN 怎样读取线串中的指定顶点
- 337浏览 收藏
-
- 数据库 · MySQL | 4小时前 | MySQL · mysql Performance Schema 事务聚合 账户统计
- MySQL events_transactions_summary_by_account_by_event_name 怎样按账户读取事务等待聚合
- 396浏览 收藏
-
- 数据库 · MySQL | 5小时前 |
- MySQL performance_schema.host_cache 怎样读取主机解析状态与连接错误计数
- 309浏览 收藏
-
- 数据库 · MySQL | 18小时前 | mysql innodb INNODB_TABLESPACES ENCRYPTION 表空间加密
- MySQL INNODB_TABLESPACES_ENCRYPTION 怎样查看表空间加密状态
- 130浏览 收藏
-
- 数据库 · MySQL | 18小时前 |
- MySQL SHOW ERRORS 和 SHOW WARNINGS 应该怎么选
- 144浏览 收藏
-
- 数据库 · MySQL | 18小时前 |
- MySQL IS_IPV4_COMPAT 怎样识别 IPv4 兼容地址
- 496浏览 收藏
-
- 数据库 · MySQL | 18小时前 | MySQL · mysql compress length VARBINARY UNCOMPRESSED_LENGTH CHAR_LENGTH
- MySQL UNCOMPRESSED_LENGTH 怎样读取压缩前的字节数
- 148浏览 收藏
-
- 数据库 · MySQL | 19小时前 |
- MySQL JSON_TABLE 怎样处理缺失字段的 DEFAULT ON EMPTY
- 234浏览 收藏
-
- 数据库 · MySQL | 19小时前 |
- MySQL HANDLER READ 怎样按索引逐行读取表数据
- 490浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1095次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1092次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1256次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1046次使用
-
- MySQL 明明加了索引,为什么查询还是很慢?先查这 6 个点
- 2026-06-27 374浏览
-
- golang MySQL实现对数据库表存储获取操作示例
- 2022-12-22 499浏览
-
- golang 基于 mysql 简单实现分布式读写锁
- 2023-01-07 384浏览
-
- 详解如何利用GORM实现MySQL事务
- 2023-01-07 184浏览
-
- Go语言实现操作MySQL的基础知识总结
- 2023-01-23 265浏览

