---
title: "SlowSQL 诊断 | OceanBase 文档中心"
description: SlowSQL 诊断 SlowSQL 是指执行超过一定时间的 SQL，您可通过 SlowSQL 诊断识别风险语句，规避风险。 设置一般 SQL 执行时间 默认配置下，执行时间超过 100ms 的为慢 SQL。您可如下方法修改 SlowSQL 判定的默认阈值： 黑屏或使用 OceanBase 开发者中心（OceanBa…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 3.2.3 企业版

# SlowSQL 诊断

更新时间：2023-08-09 10:06:09

SlowSQL 是指执行超过一定时间的 SQL，您可通过 SlowSQL 诊断识别风险语句，规避风险。

## 设置一般 SQL 执行时间

默认配置下，执行时间超过 100ms 的为慢 SQL。您可如下方法修改 SlowSQL 判定的默认阈值：

1. 黑屏或使用 OceanBase 开发者中心（OceanBase Developer Center，ODC）执行如下 SQL 修改 SlowSQL 判定的默认阈值为 120000 微秒。

   ```javascript
   select collect_elapsed_threshold_us from ob_agent_collection_config_history
   where collection_name = 'slow_sql';
   update ob_agent_collection_config_history set collect_elapsed_threshold_us = 120000 where collection_name = 'slow_sql';

   ```
 2. 再修改 OCP 系统参数 ocp.ob.slowsql.threshold 的值为 120000 微秒。

## **操作步骤**

1. 在左导航栏单击 **租户** ，并在 **租户列表** 中单击具体的租户进入租户 **总览** 页面。
 2. 在左侧导航栏单击 **SQL 诊断** ，进入 **SQL 诊断** 页签。

   若集群参数 enable_sql_audit 和租户参数 ob_enable_sql_audit 中任何一个未配置成打开，则 **SQL 诊断** 页面将缺失 SQL 诊断数据。可通过提示中的按钮修改参数值。

   ![08251639](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/3045889261/p312416.png)
 3. 单击 **SlowSQL** 页签。
 4. 对 SlowSQL 进行筛选。

      1. 配置筛选条件

             - 时间范围：可在 **时间范围** 下拉框中选择 近 5 分钟、近 10 分钟、近 20 分钟、近 30 分钟、近 1 小时、近 3小时来快速选择时间范围；也可在下拉框中选择自定义时间，并配置开始时间和结束时间。默认显示近 30 分钟内的信息。
             - OBServer：选择 OBServer，查询时将只查询在该 OBServer 上执行的 SQL。
             - 内部 SQL：若勾选，则查询结果中会包含由 OceanBase 内部发起的 SQL。
             - 关键词：查询结果中会显示 SQL 文本中包含该关键词的 SQL。
             - 高级搜索：下拉框中选择 **SQL ID、执行次数、每秒执行次数** 等指标，并配置指标值，查询时将获取指标满足条件的 SQL 展示在查询结果列表中。

        ![08251824](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5063421361/p312510.png)
      2. 单击 **查询** ，下方列表中将展示所有符合查询条件的 SQL。
 5. 单击 **导出 SlowSQL** 按钮，将导出列表中展示的所有SQL。
 6. 查看 SlowSQL 信息。

      1. 单击 **列管理** ，即可在弹出框中选择需要查看的信息。勾选完成后即可在 TopSQL 列表中查看到相关信息。

        ![1122](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9095987361/p355801.png)
      2. 在 SlowSQL 页签下， 可查看在刚刚选择的列信息。可复制 SQL 文本，根据数据库和用户对 SQL 文本进行筛选，根据执行次数、总响应时间、响应时间和 CPU 时间对 SQL 文本进行排序。 ![1](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5702730261/p268808.png)
      3. 单击 SQL 文本下内容，您可进入具体 SQL 页面。

             1. 您可在 **SQL 文本** 区域 **复制** 或 **查看全部** SQL 信息。 ![1](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/5702730261/p268838.png)
             2. 查看 SQL 执行明细：您可查看近 5 分钟、近 10 分钟、近 20 分钟、近 30 分钟、近 1 小时、近 3小时或自定义时间内的 TraceID、请求时间、响应时间、执行时间、物理读、返回行数、Server IP、客户端 IP信息。支持复制 TraceID；根据请求时间、响应时间、执行时间、物理读对 SQL 进行排序。

               物理读：从物理磁盘中读取数据的次数。

               ![1](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6702730261/p268841.png)
             3. 查看历史趋势：您可选择不同 IP、不同时间段的不同指标查看历史趋势。![1](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9608630261/p268595.png)
             4. 查看执行计划：通过选择不同的 OBServer 和时间区间，查看 **Plan Hash、合并版本、执行计划类型、计划生成时间、CPU 时间** 和 **命中率** 。并可对 **Plan Hash** 进行复制。

               ![09101058](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6063421361/p325808.png)

               单击 **Plan Hash** 列的内容，您可查看执行计划详情。

               ![09101101](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6063421361/p325810.png)

               继续单击 Server IP 列的内容，您可查看该 Plan 在这台服务器上的执行详情。
             5. 查看索引绑定：您可根据索引状态和类型对索引进行筛选；也可以单击 **未绑定** ，将该 SQL 与索引绑定。您可通过黑屏或连接 OceanBase 开发者中心（OceanBase Developer Center，ODC）创建索引。

#### 说明

OUTLINE 功能的实现基于 OceanBase 本身支持的 HINT 功能和 plan cache 功能。HINT 通过指定索引，指定连接方法等影响物理计划的生成路径选择。plan cache 将物理执行计划缓存起来，当在同样的环境下，同一 SQL 的处理不再需要经过 parser，resolver，rewrite，optimizer 等环节来生成物理执行计划，直接从 plan cache 中获取，加快 SQL 语句的执行。 OUTLINE 功能通过 HINT 来描述具体如何固定计划，通过改变 plan cache 中查询对应的物理执行计划，来起到固定物理计划的效果。

```
     OCP 提供索引绑定 Outline 功能，用户选定一个索引绑定在一个 SQL ID 上，从而让 OB 在执行时选择这个索引, 目前一个 SQL ID 仅支持绑定一个索引。关于绑定，也可参考 OceanBase 的 [计划绑定](https://www.oceanbase.com/docs/oceanbase-database/oceanbase-database/V2.2.30/plan-binding) 来理解。

     ![2](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9608630261/p268597.png)

```

 上一篇 下一篇 ![有帮助](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) 咨询热线
