MySQL PS_CURRENT_THREAD_ID 怎样取得当前会话的内部线程编号

要取得当前 MySQL 会话在 Performance Schema 中的内部线程编号，直接调用 PS_CURRENT_THREAD_ID() 即可。它返回当前连接对应的 THREAD_ID，用于关联 Performance Schema 的线程维度数据；这个编号不是客户端看到的 PROCESSLIST_ID，也不要把两者混用。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/performance-schema-functions.html

下面按 MySQL 8.4 官方函数说明展开。SQL 示例只用于解释查询关系，没有在本机数据库执行，也不代表某个实例会返回固定数字。

先分清连接编号和内部线程编号

SHOW PROCESSLIST 中的 Id，以及 CONNECTION_ID() 返回的值，属于连接标识；Performance Schema 的线程表则使用 THREAD_ID。监控语句如果要关联 performance_schema.threads、等待事件或线程统计，通常需要后者。

两种编号可能在某次示例中看起来相同，但它们的字段语义不同。把连接编号直接拿去匹配 THREAD_ID，会让查询在特定实例上“碰巧有结果”，却不能形成稳定的监控约定。

用 PS_CURRENT_THREAD_ID 取得当前会话编号

函数没有参数，返回一个 BIGINT UNSIGNED 类型的 Performance Schema 线程编号。最小查询如下：

-- 读取当前连接在 Performance Schema 中的内部线程编号
SELECT PS_CURRENT_THREAD_ID() AS thread_id;

得到的 thread_id 可以作为后续线程维度查询的条件。函数的重点是“当前连接”：它不需要先从进程列表读取连接号，也不需要把客户端编号手工转换成内部编号。

如果只是显示当前会话的连接号，应使用 CONNECTION_ID()；如果要进入 Performance Schema 的线程表或事件表，则应先确认查询需要的是 PROCESSLIST_ID 还是 THREAD_ID。

需要按连接查找时怎样映射

当手里只有某个连接号，可以调用 PS_THREAD_ID(connection_id)。当前连接的等价写法可以使用 CONNECTION_ID() 作为参数：

-- 把当前连接标识转换为 Performance Schema 的线程标识
SELECT
  CONNECTION_ID() AS processlist_id,
  PS_THREAD_ID(CONNECTION_ID()) AS thread_id;

-- 按连接号查找线程时，传入的值对应 PROCESSLIST_ID
SELECT PS_THREAD_ID(12345) AS thread_id;

官方文档将连接参数对应到 Performance Schema threads 表的 PROCESSLIST_ID，返回值对应 THREAD_ID。因此，外部连接号到内部线程号的映射应由函数完成，而不是在应用层猜测编号规律。

NULL 和报错边界要单独处理

PS_THREAD_ID() 在没有对应线程编号时可能返回 NULL，例如线程没有被纳入可用的线程实例内存。官方说明中，performance_schema_max_thread_instances 为零时不会分配线程内存，函数也会返回 NULL；如果 Performance Schema 整体被关闭，则相关函数会产生错误。

这意味着监控 SQL 不能把 NULL 当成线程编号零，也不能把“函数报错”当成普通的无匹配。可以把转换结果保留下来，再由调用方决定是跳过、记录还是提示配置问题：

-- 保留 NULL，让监控程序区分“没有映射”和有效编号
SELECT
  CONNECTION_ID() AS processlist_id,
  PS_THREAD_ID(CONNECTION_ID()) AS thread_id,
  CASE
    WHEN PS_THREAD_ID(CONNECTION_ID()) IS NULL THEN '无可用线程映射'
    ELSE '已取得内部线程编号'
  END AS mapping_state;

示例中的文字状态只是查询结果的业务解释，不是 MySQL 固定返回值。生产代码还应对 Performance Schema 未启用、线程实例不足和权限不足等环境差异分别记录错误。

把 THREAD_ID 用在正确的监控关系中

可以把 PS_CURRENT_THREAD_ID() 视为当前会话进入 Performance Schema 线程维度的入口。查询事件或线程信息时，使用取得的 THREAD_ID 去匹配对应表的线程字段；展示连接信息时，再保留 PROCESSLIST_ID 作为人能识别的外部标识。

这样设计后，外部日志可以记录连接编号，Performance Schema 查询使用内部线程编号，两者各自承担清晰职责。若查询结果为空或函数报错，先检查 Performance Schema 状态和线程实例配置，再判断是否是映射逻辑问题。

相关问题

PS_CURRENT_THREAD_ID() 和 PS_THREAD_ID(NULL) 一样吗？

不要按参数形式推断。MySQL 8.4 文档明确把 PS_CURRENT_THREAD_ID() 作为取得当前连接线程号的函数；PS_THREAD_ID() 需要传入连接编号。

为什么 THREAD_ID 和连接 ID 有时数值相同？

数值偶然相同不代表字段含义相同。监控查询应按字段语义和官方函数映射建立关系，不能依赖编号增长规律。

函数返回 NULL 应该改成 0 吗？

不建议直接改成零。NULL 表示没有可用映射或没有对应线程，转换成零会掩盖配置或采集边界；是否显示占位文本应由监控业务决定。