4. MySQL 慢查询排查工具链

在报表导出服务中，慢查询是导致接口超时、Redis 热点堆积的根源之一。本节系统讲解三个核心排查工具：EXPLAIN 执行计划、pt-query-digest 慢查询日志分析、Performance Schema，并给出它们在报表导出场景下的联动使用策略。

4.1 EXPLAIN 执行计划分析

EXPLAIN 是 MySQL 提供的查询优化器执行计划查看命令。在报表导出场景中，多表 JOIN、子查询、大范围扫描是常见性能瓶颈，EXPLAIN 能直接暴露这些风险。

4.1.1 基本用法

-- 在慢查询 SQL 前加 EXPLAIN
EXPLAIN SELECT
    o.order_id, o.amount, u.name
FROM orders o
JOIN users u ON o.user_id = u.id
WHERE o.created_at BETWEEN '2025-01-01' AND '2025-01-31'
ORDER BY o.amount DESC
LIMIT 1000;

4.1.2 关键字段解读

4.2 慢查询日志分析工具：pt-query-digest

pt-query-digest 是 Percona Toolkit 中的慢查询日志分析利器。它能从大量慢查询日志中自动聚合出最耗时的 SQL 模板，并给出执行次数、总耗时、平均耗时、锁等待等统计指标。

4.2.1 启用慢查询日志

-- 临时启用（生产环境谨慎）
SET GLOBAL slow_query_log = ON;
SET GLOBAL long_query_time = 1;      -- 超过 1 秒记录
SET GLOBAL log_queries_not_using_indexes = ON;

-- 查看日志路径
SHOW VARIABLES LIKE 'slow_query_log_file';

4.2.2 使用 pt-query-digest 分析

# 分析慢查询日志，输出排名前 10 的查询
pt-query-digest /var/lib/mysql/slow.log --limit 10

# 输出到文件，便于后续对比
pt-query-digest /var/lib/mysql/slow.log > slow_report.txt

4.2.3 输出解读

4.3 Performance Schema 的使用

Performance Schema 是 MySQL 5.7+ 内置的性能监控引擎，能提供语句级、阶段级、等待事件级的细粒度数据。在报表导出场景中，它比 EXPLAIN 更擅长诊断锁等待、IO 瓶颈、索引使用统计。

4.3.1 启用与配置

-- 检查是否启用
SHOW VARIABLES LIKE 'performance_schema';

-- 启用（需在 my.cnf 中配置后重启）
performance_schema = ON

-- 启用语句事件采集
UPDATE performance_schema.setup_consumers
SET ENABLED = 'YES'
WHERE NAME LIKE 'events_statements%';

-- 启用等待事件采集
UPDATE performance_schema.setup_instruments
SET ENABLED = 'YES', TIMED = 'YES'
WHERE NAME LIKE 'wait/io/%';

4.3.2 常用查询

-- 查询最近 10 条最耗时的 SQL
SELECT
    DIGEST_TEXT,
    COUNT_STAR AS exec_count,
    SUM_TIMER_WAIT / 1000000000 AS total_sec,
    AVG_TIMER_WAIT / 1000000000 AS avg_sec,
    SUM_LOCK_TIME / 1000000000 AS lock_sec
FROM performance_schema.events_statements_summary_by_digest
ORDER BY SUM_TIMER_WAIT DESC
LIMIT 10;

-- 查询索引使用情况
SELECT
    OBJECT_SCHEMA,
    OBJECT_NAME,
    INDEX_NAME,
    COUNT_STAR AS access_count,
    SUM_TIMER_WAIT / 1000000000 AS total_sec
FROM performance_schema.table_io_waits_summary_by_index_usage
WHERE INDEX_NAME IS NOT NULL
ORDER BY total_sec DESC
LIMIT 10;

4.3.3 与 EXPLAIN 的对比

4.4 工具联动流程

在报表导出服务中，三个工具按以下流程联动，形成闭环排查体系：

1. 阶段一：全局扫描 — 使用 pt-query-digest 分析慢查询日志，定位 Top N 慢 SQL 模板。
2. 阶段二：单条分析 — 对 Top SQL 执行 EXPLAIN，检查 type、key、rows、Extra 字段，确定索引缺失或扫描过大。
3. 阶段三：深度诊断 — 使用 Performance Schema 确认锁等待时间、IO 压力、索引实际使用频率。
4. 阶段四：验证优化 — 添加索引或改写 SQL 后，再次用 pt-query-digest 对比优化前后的响应时间变化。

4.5 报表导出场景实战案例

某报表导出服务在整点导出时频繁超时，通过上述工具链排查过程如下：