当前位置:首页 > 文章列表 > 数据库 > MySQL > MySQL session_connect_attrs 怎样读取客户端提交的连接属性

MySQL session_connect_attrs 怎样读取客户端提交的连接属性

来源:17golang原创 2026-11-18 14:56:04 0浏览 收藏

排查一条 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属性加入集合时的顺序适合让同一连接的属性按原顺序显示
MySQL session_connect_attrs 全会话范围和字段含义的静态结构框图
图1:静态说明图展示全会话连接属性从客户端到 session_connect_attrs 的字段关系,不是截图或运行证据。

属性名称并不是一份对所有客户端都完全相同的固定清单。官方文档列出的常见属性包括 _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;
按 PROCESSLIST_ID 和 ATTR_NAME 筛选 MySQL 连接属性的静态查询结构图
图2:静态说明图展示按连接和属性名筛选的查询结构,并对比当前账户范围表,不是截图或运行证据。

筛选结果为空时,先确认连接是否仍然存在,再确认客户端是否真的提交了该属性。不要因为某个 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 语法问题,可以按三个方向判断:

  1. 客户端或 Connector 没有提交你要找的属性。属性集合会随客户端、平台和 Connector 变化。
  2. 查询范围不对。你需要全服务器连接,却查询了 session_account_connect_attrs,或者目标连接已经断开。
  3. 属性总长度超过 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,它的范围是当前会话和同一账户关联的会话。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
快递运单保价 怎样区分声明价值与实际物品价值快递运单保价 怎样区分声明价值与实际物品价值
上一篇
快递运单保价 怎样区分声明价值与实际物品价值
Redis FUNCTION LIST WITHCODE 怎样同时查看函数库信息与代码
下一篇
Redis FUNCTION LIST WITHCODE 怎样同时查看函数库信息与代码
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1092次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1256次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1197次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1046次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码