ByteHouse 企业版支持 SQL 诊断，通过收集慢 Query 日志，提供多维度的性能指标、趋势和明细分析，帮助您洞察集群与实例的性能表现，精准定位低效查询，从而实现针对性的 SQL 优化。该功能适用于数据库性能瓶颈排查、周期性系统健康巡检、或特定业务模块 SQL 效率分析等场景。本文介绍了如何使用 SQL 诊断功能。

SQL 诊断是 ByteHouse 提供的查询优化诊断工具，其主要功能包括：

• 慢 Query 采集：采集所有 Query，获取集群 Top 耗时的 Query，形成详细的慢 Query 日志。
• 诊断分析能力：基于慢 Query 日志的数据，ByteHouse 通过对不同维度的趋势、明细分析，帮助您识别低效查询模式，优化资源分配，并实现针对性的 SQL 调优。

当前 ByteHouse 支持的诊断项包括：

使用前，请确保您拥有 Cluster Admin 或 System Admin 权限。如果您尚未获取此权限，请联系管理员授权，详情请参考管理用户的角色权限。

登录 ByteHouse 企业版控制台，单击顶部诊断优化页签，单击SQL 诊断，进入功能页面。选择集群及时间范围，单击诊断，系统将自动分析并展示当前集群中在指定时间范围内执行的 SQL 情况。各类诊断项可用于协助诊断查询情况，您可结合您的业务问题及诊断项，分析问题原因，并采取相应的优化措施。

洞察明细

洞察明细展示了当前集群整体 Query 执行情况，您可通过此类诊断项快速发现异常时段，例如，

• 如果出现 Query 总量过高，可能存在异常流量或业务高峰，需检查是否超出集群负载能力。
• 如果在失败 Query 趋势中发现某个时段中失败率骤升，您可结合失败 Query 明细中的内容，批量优化问题 SQL 或调整集群资源配置。
• 如果发现某个时间段内 Query 存在长时间执行情况，可结合耗时 Top5 Query 统计信息，定位潜在的慢查询瓶颈。
• ByteHouse 也列出了失败 Query 明细，您可单击 Query ID 跳转至查询 Query 洞察页面，查看查询概览及错误详情。

DML 分析

DML 分析展示了当前集群中 DDL 和 DML 的执行趋势，您可监控操作频率、识别异常波动，辅助评估元数据变更及数据读写对集群的影响。

• 监控 DML 趋势，了解 ALTER/INSERT 的请求压力波动。
• 您可关注 DDL 操作趋势识别高频元数据变更（如短时间内大量建表 / 改表），辅助判断锁争用风险。

Query 分析

Query 分析展示了当前集群中 Query 的来源分布和执行 Query 的用户，您可根据趋势图及失败 Query 趋势共同分析 Query 失败来源。

• 通过应用来源分布可识别高负载查询的发起端（如某类连接驱动程序），判断是否与业务预期一致。您可结合失败 Query 趋势分析特定来源的失败集中性问题。
• 如果观察到某用户有过多查询且不符合业务实际情况，可排查是否存在资源滥用或按需调整资源配额限制。
• 如果出现非预期来源的查询，可确认是否为配置错误或异常请求。

损耗 Top5

损耗分析提供了执行耗时、消耗 CPU 及内存资源最多的 Query 及明细，并支持 SQL 指纹分析，帮助您识别影响系统性能的查询。

• 单条 Query 诊断：耗时、消耗 CPU、消耗内存等诊断项列出了消耗最高的单条 Query 明细，您可单击 Query ID 查看 Query 洞察详情，结合 Query 洞察，优化该 Query。
• 同类查询聚合分析：SQL 指纹分析统计了同类查询的总消耗，可发现全局性问题。您可单击 Query ID 查看 Query 洞察详情，结合 SQL 指纹分析的指标和 Query 洞察，分析此类查询的行为特征，并根据您的业务情况针对性分析问题，定位原因，进行针对性优化。