> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pawsql.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> PawSQL 是一个产品：Cloud 是公网部署形态，Engine / Optimizer / Auditor / Advisor / Patroller 是同一产品的组件与交付形态，不是彼此独立的产品。 / PawSQL is a single product: Cloud is the public deployment form, while Engine / Optimizer / Auditor / Advisor / Patroller are components and delivery forms of the same product, not separate products.
> 术语以站内术语表为准：SQL 审核对应英文 SQL Review，查询重写对应 Query Rewrite，索引推荐对应 Index Recommendation；英文内容统一用 Review，不用 Audit。 / Use the site glossary for terminology: 审核 is SQL Review, 重写 is Query Rewrite, 索引推荐 is Index Recommendation; English content uses Review, never Audit.
> 引用能力范围或版本支持时以对应页面为准；标注 unknown、或 status 非 published 的内容表示尚未经产品核实，不应作为事实引用。 / Cite capability scope and version support from the corresponding page; content marked unknown, or with a status other than published, is not yet product-verified and must not be cited as fact.

# SQL 聚合与去重

> 慢查询采集后按 SQL 结构自动聚合去重，用「只展示业务SQL」过滤内部 SQL，从概要、SQL 类型、优化状态与平均耗时了解治理清单。

慢查询日志里同一个 SQL 会被反复执行成千上万次，逐条展示没有治理价值。PawSQL 在采集后按 SQL 结构自动聚合去重，把相同结构的 SQL 合并为一条，并用执行次数、平均耗时、最大耗时等指标刻画它的整体影响。慢查询页的概要、图表与表格都基于聚合后的结果。

<Frame caption="慢查询页：概要、近七天慢 SQL、SQL 类型、优化状态与平均耗时">
  <img src="https://mintcdn.com/pawsql/cdtFYB4QMM1nGHhK/images/performance/patrol-slow-queries-data.png?fit=max&auto=format&n=cdtFYB4QMM1nGHhK&q=85&s=92f4004ed783f3f4a8db3a4d4e59dc2f" alt="慢查询聚合结果" width="1920" height="889" data-path="images/performance/patrol-slow-queries-data.png" />
</Frame>

## 目标

按 SQL 结构对采集到的慢 SQL 聚合去重，使相同结构的 SQL 在治理清单中只保留一条。

## 准备工作

慢 SQL 已采集进入平台，聚合在采集结果之上进行。

## 操作步骤

采集完成后平台自动聚合去重；用「只展示业务SQL」开关、概要指标、分布图表、表格与筛选条件查看治理清单。

## 只展示业务 SQL

概要区右上角的「只展示业务SQL」开关用于过滤采集结果中的内部/系统 SQL。开启（默认）时只保留业务 SQL，关闭时展示全部慢 SQL。

实测示例：某实例采集到慢SQL数 `27`，其中业务SQL数 `23`，即 `4` 条为内部/系统 SQL（如 `pawsql_internal.*`、`pawsql_foreign.*` 等表上的查询）。

## 概要指标

| 指标     | 说明                     |
| ------ | ---------------------- |
| 慢查询阈值  | 采集使用的慢查询判定阈值（秒）        |
| 慢SQL数  | 采集到的慢 SQL 总数（含非业务 SQL） |
| 业务SQL数 | 过滤内部/系统 SQL 后的数量       |
| 最新采集时间 | 最近一次采集完成时间             |

## 分布图表

慢查询页用四个图表概括聚合后的治理清单：

* **近七天慢SQL**：按天统计的慢 SQL 数量趋势；
* **SQL类型**：按 SQL 类型（如 `query`）统计的数量分布；
* **优化状态**：按「未优化 / 已优化」等状态统计的数量分布；
* **平均耗时**：平均耗时最高的若干条 SQL 及其耗时，用于优先定位。

实测示例中，采集到的 23 条业务 SQL 均为 `query` 类型、优化状态均为「未优化」，平均耗时最高的一条达 `119110.03` 秒。

## 表格字段

聚合后的慢查询表格列出每条 SQL 及其聚合指标：

| 列       | 说明                            |
| ------- | ----------------------------- |
| 编号      | SQL 的唯一标识                     |
| 文本      | SQL 语句（参数化展示）                 |
| 类型      | SQL 类型（如 `query`）             |
| 表       | 涉及的表的数量                       |
| 最近执行    | 最近一次执行时间                      |
| 平均耗时(s) | 聚合后的平均执行耗时                    |
| 执行次数    | 聚合周期内的执行次数                    |
| 最大耗时(s) | 单次执行的最大耗时                     |
| 性能提升(%) | 优化后相对原 SQL 的性能提升，未优化时显示 `N/A` |
| 优化状态    | 未优化 / 已优化                     |
| 最近优化    | 最近一次优化时间                      |
| 处置阶段    | 未处置 / 处置中 / 已处置               |

## 筛选与排序

表格上方提供筛选条件：搜索慢查询 SQL 或编号、优化状态、SQL 类型、处置阶段、平均耗时区间、执行时间区间。列头支持排序，便于按平均耗时、执行次数等维度定位重点 SQL。

## 预期结果

慢查询页展示聚合后的治理清单：概要计数、四个分布图表，以及按 SQL 结构去重后的表格。

## 验证

确认概要、图表与表格均基于聚合结果，且切换「只展示业务SQL」会改变业务 SQL 数量。

## 延伸阅读

<CardGroup cols={2}>
  <Card title="慢查询采集" href="/user-guide/performance/collect-slow-sql" />

  <Card title="批量分析与优化" href="/user-guide/performance/batch-optimize" />

  <Card title="跟踪治理进度" href="/user-guide/performance/track-progress" />
</CardGroup>