MySQL 分类分钟占比计算全攻略

本文介绍如何在单条 SQL 查询中直接计算各分类（cat）的分钟数占总分钟数的百分比，避免 PHP 后处理，提升性能与可维护性，并给出正确实现、常见陷阱及优化建议。

本文介绍如何在单条 SQL 查询中直接计算各分类（cat）的分钟数占总分钟数的百分比，避免 PHP 后处理，提升性能与可维护性，并给出正确实现、常见陷阱及优化建议。

在 MySQL 中为分组结果动态计算百分比（如各分类分钟数占总分钟数的比例），最高效的方式是在 SQL 层完成聚合与比例计算，而非先取数据再用 PHP 循环计算——这不仅减少网络传输和应用层逻辑复杂度，还能利用数据库的优化器进行一次性聚合。

核心思路是：将“全量总分钟数”作为标量子查询或派生表（derived table），与分组结果做关联或交叉连接（CROSS JOIN），从而在每行中访问全局汇总值。但需特别注意：原始答案中使用的 CROSS JOIN 方式存在严重逻辑缺陷——其子查询 t 未做聚合，却使用 DISTINCT nid, cat, ...，导致笛卡尔积膨胀和结果失真（如返回 16 行却声称“Total minutes was 5344”，说明子查询未正确求和）。

✅ 正确做法是：用标量子查询（scalar subquery）计算全局总分钟数，简洁、安全、语义清晰：

SELECT 
  COUNT(DISTINCT cn.nid) AS tagged,
  cn.cat,
  SEC_TO_TIME(AVG(TIME_TO_SEC(cn.duration))) AS duration,
  ROUND(SUM(TIME_TO_SEC(cn.duration)) / 60, 0) AS minutes,
  CONCAT(
    ROUND(
      (SUM(TIME_TO_SEC(cn.duration)) / 60) * 100.0 / 
      (SELECT COALESCE(ROUND(SUM(TIME_TO_SEC(cn2.duration)) / 60, 0), 0)
       FROM client_note cn2
       JOIN client_note_tag_items cni2 ON cni2.note_id = cn2.nid
       LEFT JOIN client_note_tags cnt2 ON cnt2.tag_id = cni2.tag_id
       WHERE cn2.dte >= ? 
         AND cn2.dte <= ? 
         AND cn2.name NOT LIKE 'Resolution%'
         AND cn2.duration IS NOT NULL),
      2
    ),
    '%'
  ) AS percent
FROM client_note cn
JOIN client_note_tag_items cni ON cni.note_id = cn.nid
LEFT JOIN client_note_tags cnt ON cnt.tag_id = cni.tag_id
WHERE cn.dte >= ? 
  AND cn.dte <= ? 
  AND cn.name NOT LIKE 'Resolution%'
  AND cn.duration IS NOT NULL
GROUP BY cn.cat
ORDER BY cn.cat ASC;

? 关键要点说明：

• 标量子查询更可靠：SELECT ... FROM (...) 子查询若返回多行会报错，强制保证全局总值唯一；而 CROSS JOIN 易因逻辑错误引入重复或空行。
• COALESCE(..., 0) 防零除：当无匹配记录时，总分钟数为 NULL，COALESCE 确保分母不为空，避免 NULL 传播。
• CONCAT(..., '%') 格式化输出：比 FORMAT() 更可控（FORMAT() 会添加千位分隔符，如 1,80%），且明确保留两位小数。
• 参数占位符复用注意：SQL 中 ? 占位符需按执行顺序传入对应参数（共 4 个：起始日期×2，结束日期×2）。实际使用 PDO 时，应确保 $stmt->execute([$start, $end, $start, $end])。

⚠️ 注意事项：

• 时间字段 duration 必须为 TIME 类型（如 '00:06:22'），否则 TIME_TO_SEC() 将返回 0；
• WHERE 条件（尤其是 duration IS NOT NULL 和 name NOT LIKE）必须在主查询和子查询中严格一致，否则百分比基准失真；
• 若数据量极大，可考虑将总分钟数预先查出并缓存于 PHP 变量中，再通过 UNION ALL 或应用层计算，避免重复全表扫描。

总结：优先在 SQL 层完成百分比计算，采用标量子查询获取全局总和，配合 ROUND 与 CONCAT 实现专业、健壮、易读的结果输出——这是兼顾性能、准确性和可维护性的最佳实践。