MySQL FORMAT_PICO_TIME 怎样格式化监控计时器值

我在整理 Performance Schema 监控数据时，最容易混淆的是计时字段的单位：它们通常以皮秒保存，直接展示很难读。MySQL 的 FORMAT_PICO_TIME() 正好负责把这个数值转换成带单位的字符串，例如纳秒、微秒、毫秒或分钟。

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

把 Performance Schema 的计时值交给 FORMAT_PICO_TIME(time_val) 即可。它按输入大小自动选择单位，结果是用于展示的字符串；如果还要做排序、阈值判断或聚合，应保留原始数值。

先把皮秒值交给 FORMAT_PICO_TIME

这个函数的参数是 Performance Schema 中表示延迟或等待时间的皮秒数，不是秒数。最小用法是直接在 SELECT 中传入一个数值：

SELECT
    /* 把皮秒计时值转换为带单位的可读字符串 */
    FORMAT_PICO_TIME(3501) AS short_wait,
    /* 用较大的皮秒值观察分钟单位的展示 */
    FORMAT_PICO_TIME(188732396662000) AS long_wait;

官方手册给出的示例分别得到 3.50 ns 和 3.15 min。这里的重点不是记住某个结果，而是确认输入单位：如果把微秒或毫秒误当成皮秒，结果会缩小很多个数量级。

自动单位不是固定格式

FORMAT_PICO_TIME 会根据数值大小选择单位，并保留两位小数；小于 1 纳秒的时间以整数表示，不做小数舍入。可以把范围记成下面这张速查表：

因此它适合放在报表或诊断结果的展示列中，但不适合替代原始计时字段。需要比较两个事件时，应使用原始数值排序，再把排序后的结果交给函数格式化。

把格式化结果放进监控查询

实际监控通常同时需要事件维度、原始计时和可读文本。下面是一个查询形状示例，重点是保留原始指标，并额外生成展示列：

SELECT
    /* 事件名保留原始维度，方便定位具体等待类型 */
    EVENT_NAME,
    /* SUM_TIMER_WAIT 用于排序和阈值判断，单位仍是皮秒 */
    SUM_TIMER_WAIT,
    /* COUNT_STAR 说明该事件累计出现次数 */
    COUNT_STAR,
    /* 仅把原始计时转换为阅读友好的文本 */
    FORMAT_PICO_TIME(SUM_TIMER_WAIT) AS total_wait_readable
FROM performance_schema.events_waits_summary_global_by_event_name
/* 展示时优先把累计等待最高的事件放在前面 */
ORDER BY SUM_TIMER_WAIT DESC;

这段 SQL 是文章中的结构示例：格式化列服务于阅读，SUM_TIMER_WAIT 服务于排序和后续计算。若监控系统需要机器解析，建议把原始列和格式化列一起输出，不要只保留带单位的字符串。

NULL、舍入和旧函数的三个边界

第一，参数为 NULL 时返回的也是 NULL。如果报表把空值显示成 0，应该在展示层明确处理，而不是误以为函数把缺失计时当成零。

第二，普通值会按规则保留两位小数，至少保留三位有效数字；小于 1 纳秒的值以整数表示。这种格式适合人读，不应拿格式化文本做精确运算。

第三，MySQL 内置函数可以在任意数据库中直接调用，不需要加 schema 前缀。它用于替代已弃用的 sys.format_time() 时要留意：分钟单位使用 min，而旧函数使用 m；内置函数也不使用旧函数的周单位 w。

SELECT
    /* 空值保持为空值，避免把缺失数据伪装成零耗时 */
    FORMAT_PICO_TIME(NULL) AS empty_value,
    /* 机器判断仍使用原始值，格式化值只作为阅读列 */
    FORMAT_PICO_TIME(1000000000) AS one_millisecond;

排查计时显示异常时先看什么

我通常按三个问题排查：输入列是不是 Performance Schema 的皮秒字段；排序是不是仍然使用原始数值；旧报表是否把 m、min 或 w 当成固定单位解析。只要把原始列、格式化列和事件名放在同一结果集中，定位会比只看一串带单位的文本快得多。

如果你只需要给人看的监控摘要，直接使用 FORMAT_PICO_TIME()；如果要做告警、聚合或跨系统传输，保留原始皮秒值，并把格式化字符串当作附加字段。

相关问题

FORMAT_PICO_TIME 能格式化秒数吗？不能直接按秒解释参数，它要求传入皮秒计时值；秒数需要先按你的数据模型转换为皮秒。

为什么结果显示成 us 而不是 μs？函数使用固定的 ASCII 单位标识，例如 us、min，便于日志和监控系统处理。

格式化后还能按耗时排序吗？不建议。按原始计时列排序，格式化列只用于展示。