--- title: "诊断 TopSQL - 云平台 OCP V4.2.2 | OceanBase 文档中心" description: 诊断 TopSQL TopSQL 是指租户中总响应时间倒序的 SQL 语句，在租户概览页面中，您可以根据时间范围、OBServer 节点对 TopSQL 进行筛选查询，并在 SQL 列表中查看 SQL 详情。 操作步骤 您可通过如下两个入口进行 TopSQL 诊断： 入口一：登录 OCP，在左侧导航栏单击 自治服务 … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.2.2 # 诊断 TopSQL 更新时间：2026-04-14 15:15:57 [编辑](https://github.com/oceanbase/ocp-doc/edit/V4.2.2/zh-CN/1000.diagnosis-and-tuning-fuctions/100.manage-sql-diagnosis/400.topsql-diagnostics.md) TopSQL 是指租户中总响应时间倒序的 SQL 语句，在租户概览页面中，您可以根据时间范围、OBServer 节点对 TopSQL 进行筛选查询，并在 SQL 列表中查看 SQL 详情。 ## **操作步骤** 您可通过如下两个入口进行 TopSQL 诊断： - 入口一：登录 OCP，在左侧导航栏单击 **自治服务**，选择需要查看的集群，进入集群 **实时诊断** 页面。 #### 说明 通过自治服务查看时，TopSQL 功能除了支持对选定租户进行实时诊断，还支持对集群内所有租户的 TopSQL 进行实时诊断。当发现某台主机 CPU 负载过高时, 可以使用该功能，对主机上的 SQL 进行排序，从而找到最值得优化的 SQL。 - 入口二：登录 OCP，进入租户 **概览** 页面，在左侧导航栏单击 **SQL 诊断**。 #### 功能适用性 社区版暂不支持自治服务，该功能需要通过 **入口二** 访问查看。 以下操作步骤以 **入口一** 为例。 1. 在左导航栏单击 **自治服务** ，并在 **集群详情** 中单击集群名进入集群 **实时诊断** 页面。 2. 系统默认进入 **SQL 诊断** 页签。 若集群参数 enable_sql_audit 和租户参数 ob_enable_sql_audit 中任何一个未配置成打开，则 **SQL 诊断** 页面将缺失 SQL 诊断数据。可通过提示中的按钮修改参数值。 ![08251800](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7204481361/p312497.png) 3. 单击 **TopSQL** 页签。 4. 对 TopSQL 进行筛选。 1. 配置筛选条件。 - 时间范围：可在 **时间范围** 下拉框中选择 近 5 分钟、近 10 分钟、近 20 分钟、近 30 分钟、近 1 小时、近 3小时来快速选择时间范围；也可在下拉框中选择自定义时间，并配置开始时间和结束时间。默认显示近 30 分钟内的信息。 - OBServer：选择 OBServer 节点，查询时将只查询在该 OBServer 节点上执行的 SQL。 - 内部 SQL：若勾选，则查询结果中会包含由 OceanBase 内部发起的 SQL。 - 关键词：查询结果中会显示 SQL 文本中包含该关键词的 SQL。 - 高级条件： **高级条件** 支持同时添加多个过滤条件。单击 **添加** ，在 **添加高级条件** 面板中，可对指标、运算符和指标值进行配置，查询时将获取指标满足条件的 SQL 展示在查询结果列表中。 ![Image 1](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/4341489461/p429708.png) 2. 单击 **查询** ，下方列表中将展示所有符合查询条件的 SQL。 支持复制 SQL 文本，并根据数据库对 SQL 文本进行筛选。支持根据执行次数、总响应时间、平均响应时间、报错次数和计划生成时间对 SQL 文本进行排序，并可查看诊断结果。 ![Image 173](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/4341489461/p429709.png) 5. 单击 **导出 TopSQL** 按钮，将导出列表中展示的所有 SQL。 6. 查看 TopSQL 信息。 1. 单击 **自定义列** ，在弹出框中对自定义列的列表达式和列名进行配置。配置完成后可在 TopSQL 列表中查看到相关信息。 #### 说明 - 目前运算符只支持"+、-、*、/"和英文括号。 - 自定义列添加后，TopSQL 将按照自定义列进行排序。 - 仅支持定义一个自定义表达式。如果已经存在自定义列，新增自定义列后，新的表达式列将代替原有自定义列。 - 自定义列的属性名前须加 @ 或 $。 ![Image 2](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/4341489461/p429710.png) 2. 单击 **列管理** ，即可在弹出框中选择需要查看的信息。勾选完成后即可在 TopSQL 列表中查看到相关信息。 ![Image 6](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/4341489461/p429711.png) 3. 单击 SQL 文本左侧的 **+** 按钮，您可查看 SQL 具体报错详情。 ![Image 3](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/4341489461/p429712.png) 4. 单击 SQL 文本，进入具体 SQL 页面。 在 **SQL 详情** 页中，您可查看该 SQL 的详细信息，包括： - 在 **SQL 文本** 处查看 SQL 的完整语句。 - 在 **优化建议** 处查看对于该 SQL 的优化建议，详见 [查看优化建议](https://www.oceanbase.com/docs/common-ocp-1000000000584925)。 - 在 **历史趋势** 页签，查看该 SQL 运行的历史趋势，详见 [查看 SQL 运行的历史趋势](https://www.oceanbase.com/docs/common-ocp-1000000000584925)。 - 在 **执行计划** 页签，查看该 SQL 的执行计划，或为其绑定执行计划，详见 [查看 SQL 的执行计划](https://www.oceanbase.com/docs/common-ocp-1000000000584925)。 - 在 **索引** 页签，查看该 SQL 的绑定的索引，详见 [查看和绑定索引](https://www.oceanbase.com/docs/common-ocp-1000000000584925)。 - 在 **SQL 限流** 页签，查看该 SQL 的限流情况，或为其设置限流，详见 [设置 SQL 限流](https://www.oceanbase.com/docs/common-ocp-1000000000584925)。 - 在 **执行计划** 、 **索引** 、 **SQL 限流** 页签的图示 ① 处，均可查看该 SQL 的绑定记录。 ![1217](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/8493479361/p371468.png) 在绑定记录中您可查看到已绑定计划的状态，可通过 **取消绑定** 按钮将 SQL 与该计划解绑，也可通过 **绑定** 按钮将二者再次绑定。 7. 设置限流。 - 单击 **设置限流** ，您可对 SQL 进行限流，详见 [设置 SQL 限流](https://www.oceanbase.com/docs/common-ocp-1000000000584925)。 - 勾选多个 SQL ，单击 **批量设置限流** ，在弹窗框中输入并发数，可对相关 SQL 进行相同并发数限流设置。 #### 说明 批量设置限流不支持进行关键字限流。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线