登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  MySQL

MySQL session_account_connect_attrs 怎样理解账户范围内的连接属性可见性

来源:17golang原创

时间:2026-11-18 17:58:13 111浏览 收藏

如果你只想看“当前连接账户能看到哪些连接属性”,优先使用 performance_schema.session_account_connect_attrs。它包含当前会话的属性,也包含与当前会话账户关联的其它会话属性;如果要看所有会话,才切换到 session_connect_attrs。

官方地址:https://dev.mysql.com/doc/refman/8.4/en/performance-schema-session-account-connect-attrs-table.html

理解这张表的关键不是把它当成“客户端列表”,而是先确定可见范围,再用 PROCESSLIST_ID 把多行键值属性归回对应连接。

一、先分清两张表的可见范围

连接属性是应用在建立连接时传给 MySQL 的键值对,例如客户端名称、连接器版本或程序自定义的标识。Performance Schema 提供两张容易混淆的表:

表能看到什么适合回答的问题
session_account_connect_attrs当前会话和同一 session account 关联的其它会话这个账户下的连接带了哪些属性?
session_connect_attrs所有会话的连接属性实例上全部连接分别带了什么属性?
MySQL 连接属性的账户范围与全会话范围关系图
图1:session_account_connect_attrs 的账户范围与全会话范围对照说明图。

因此,查询结果少于全实例连接数并不一定是异常,可能只是你选择了账户范围表。反过来,如果排查某个连接池或服务的属性分布,直接使用账户范围表也可能漏掉其它账户的连接。

二、查看四个字段怎样表达一条属性

session_account_connect_attrs 不是“一条连接一行”的列表,而是“一个属性一行”的键值表。官方文档列出四个字段:

  • PROCESSLIST_ID:会话的连接标识。
  • ATTR_NAME:属性名。
  • ATTR_VALUE:属性值。
  • ORDINAL_POSITION:属性加入该连接属性集合的顺序。

同一个 PROCESSLIST_ID 可能出现多行,例如一行记录客户端名,另一行记录客户端版本。把四个字段放在一起读,才能知道“哪个连接的哪个属性是什么值”。

MySQL 连接属性表四个字段的行关系图
图2:PROCESSLIST_ID、ATTR_NAME、ATTR_VALUE 与 ORDINAL_POSITION 的行字段关系说明图。

三、用一条查询按账户范围读取属性

下面的查询只读取当前账户可见范围,并按连接 ID、属性加入顺序排序。示例中的中文注释说明了每组字段的用途:

SELECT
    PROCESSLIST_ID,                 -- 把多行属性归回同一个连接
    ATTR_NAME,                      -- 读取客户端提交的属性名
    ATTR_VALUE,                     -- 读取该属性对应的值
    ORDINAL_POSITION                -- 保留属性加入连接集合的顺序
FROM performance_schema.session_account_connect_attrs
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;

如果你的目标是确认某个属性是否存在,可以在不改变范围的前提下增加条件:

SELECT
    PROCESSLIST_ID,                 -- 先保留连接标识,便于回到会话排查
    ATTR_NAME,                      -- 只筛选属性名,不把不同属性混在一起
    ATTR_VALUE                      -- 查看客户端实际提供的值
FROM performance_schema.session_account_connect_attrs
WHERE ATTR_NAME IN ('program_name', '_client_name') -- 只关注客户端来源标识
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;

这里的属性名取决于客户端或连接器实现。MySQL 文档说明,不同 Connector 可能定义不同属性;一些常见程序还会设置 program_name。所以不要把某个属性当作所有客户端都必然发送的固定字段。

四、怎样从返回行判断“属于谁”

可以按下面的顺序解释结果:

  1. 先看 PROCESSLIST_ID:相同值代表同一条会话连接。
  2. 再看 ATTR_NAME 和 ATTR_VALUE:它们组成这一连接的一组键值属性。
  3. 最后看 ORDINAL_POSITION:它只表示属性加入顺序,不是连接创建时间,也不是属性优先级。

例如,同一个连接 ID 下出现 program_name 和 _client_version 两行,说明这条连接提交了两个可见属性;不能把两行误读成两个连接。若需要把属性与线程、用户或主机信息一起分析,应再根据连接标识关联其它 Performance Schema 连接信息,而不是把属性表当成完整会话表。

五、账户范围不够时怎样切换到全会话

当问题变成“实例中所有账户的连接都使用了什么客户端”时,使用全会话表,查询结构保持一致:

SELECT
    PROCESSLIST_ID,                 -- 仍然按连接标识聚合属性
    ATTR_NAME,                      -- 读取全部会话的属性名
    ATTR_VALUE,                     -- 读取全部会话的属性值
    ORDINAL_POSITION                -- 保留每条连接内部的属性顺序
FROM performance_schema.session_connect_attrs
ORDER BY PROCESSLIST_ID, ORDINAL_POSITION;

这个切换只改变“可见范围”,不会改变四个字段的含义。实际排查时,可以先用账户范围缩小问题,再在需要跨账户比较时使用全会话表。

六、两个容易忽略的边界

1. 属性可能被截断

连接属性有客户端、服务端和 Performance Schema 多层大小限制。如果属性数据超过 Performance Schema 的配置上限,官方文档说明可能发生截断,并增加 _truncated 属性(空间足够时)。因此看到值不完整时,先考虑属性传输限制,不要立即判断客户端发送错误。

2. 这张表不能用 TRUNCATE 清理

官方表说明明确指出,TRUNCATE TABLE 不允许用于 session_account_connect_attrs。这张表用于观察连接属性,不能按普通业务表的方式设计定期清空脚本;需要清理历史现象时,应先回到连接生命周期和 Performance Schema 配置本身分析。

总结

session_account_connect_attrs 的“账户范围”包括当前会话和同一 session account 关联的其它会话;它不是全实例视图,也不是一连接一行。阅读时牢记三点:用 PROCESSLIST_ID 聚合多行属性,用 ORDINAL_POSITION 保留属性加入顺序,需要跨账户时切换到 session_connect_attrs。

常见问题

session_account_connect_attrs 为什么行数比连接数多?

因为它按属性记录,一条连接可以提交多个键值属性,所以同一个 PROCESSLIST_ID 出现多行是正常的。

ORDINAL_POSITION 能不能用来判断连接先后?

不能。它表示属性加入该连接属性集合的顺序,不表示连接创建时间或属性优先级。

什么时候必须改查 session_connect_attrs?

当问题要求覆盖所有会话、比较不同账户或排查未知账户的客户端来源时,使用 session_connect_attrs。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>