---
title: "查询执行计划的性能统计趋势 | OceanBase 文档中心"
description: "查询执行计划的性能统计趋势 功能说明 查询指定 SQL 的关联的执行计划的性能趋势。 调用说明 接口约束 调用者需具备指定租户的读权限。 请求路径 GET /api/v2/ob/clusters/{clusterId}/tenants/{tenantId}/plans/{uid}/trends 请求参数 参数 类型 …"
---
切换语言

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

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

# 查询执行计划的性能统计趋势

更新时间：2023-08-10 11:45:58

## **功能说明**

查询指定 SQL 的关联的执行计划的性能趋势。

## **调用说明**

**接口约束**

调用者需具备指定租户的读权限。

**请求路径**

`GET /api/v2/ob/clusters/{clusterId}/tenants/{tenantId}/plans/{uid}/trends`

**请求参数**

| 参数 | 类型 | 必选 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| clusterId | Integer | 是 | 1 | 集群的 Id |
| tenantId | Integer | 是 | 1001 | 租户的 Id |
| uid | String | 是 | AAAAAAAAAAEAAAAAAAKOvgAFs1_j8s3i | 计划的 uid |
| startTime | Datetime | 是 | 2020-02-16T05:32:16+08:00 | 开始时间 |
| endTime | Datetime | 是 | 2020-02-16T07:32:16+08:00 | 结束时间 |

**返回结果**

- 基础数据结构

  | 参数 | 类型 | 说明 |
  | --- | --- | --- |
  | data | Object | 请求的数据。 |
  | ├─ contents | Array | 计划性能采样的数组，数据结构见下表。 |
  | successful | Boolean | 请求是否成功。 |
  | timestamp | Datetime | 服务端完成请求的时间戳。 |
  | duration | Integer | 服务端处理请求的时间（毫秒）。 |
  | status | Integer | 符合 HTTP Status 规范的编码。 |
  | traceId | String | 请求的 Trace Id，用于排查问题。 |
  | server | String | 响应请求的应用服务的地址。 |
 - 计划性能采样的数据结构

  | 参数 | 类型 | 说明 |
  | --- | --- | --- |
  | timestamp | Datetime | 采样的时间戳 |
  | executions | Integer | 计划在期间内的执行次数 |
  | execPs | Float | 计划在期间内的平均每秒执行次数 |
  | maxExecTime | Float | 计划在期间内的最慢执行时间（毫秒） |
  | avgDiskReads | Float | 计划在期间内的平均磁盘读次数 |
  | avgDiskWrites | Float | 计划在期间内的平均磁盘写次数 |
  | avgBufferGets | Float | 计划在期间内的平均缓存读次数 |
  | avgApplicationWaitTime | Float | 计划在期间内的平均 Application 类事件等待时间（毫秒） |
  | avgConcurrencyWaitTime | Float | 计划在期间内的平均 Concurrency 类事件等待时间（毫秒） |
  | avgUserIoWaitTime | Float | 计划在期间内的平均 UserIO 类事件等待时间（毫秒） |
  | avgRowProcessed | Float | 计划在期间内的平均处理行数 |
  | avgElapsedTime | Float | 计划在期间内的平均响应时间 |
  | avgCpuTime | Float | 计划在期间内的平均 CPU 时间 |
  | largeQueryPercentage | Float | 计划在期间内的大查询百分比 |
  | delayedLargeQueryPercentage | Float | 计划在期间内被置入队列的大查询的百分比 |
  | timeoutPercentage | Float | 计划在期间内执行超时的百分比 |
  | tableScan | Boolean | 计划是否包含全表扫描 |

## **示例**

**请求示例**

查询集群 Id 为 1 、租户 Id 为 1001、计划 Uids 为 AAAAAAAAAAEAAAAAAAAJ_AAFszE_cnfR 的性能趋势。时间范围为 2020-11-03T19:00:00+08:00 ～ 2020-11-03T20:00。

```code
/api/v2/ob/clusters/1/tenants/1001/plans/AAAAAAAAAAEAAAAAAAAJ_AAFszE_cnfR/trends?startTime=2020-11-03T19%3A00%3A00%2B08%3A00&endTime=2020-11-03T20%3A00%3A00%2B08%3A00

```

**返回示例**

```code
{
    "duration": 818,
    "server": "a83ad33525",
    "status": 200,
    "successful": true,
    "timestamp": "2020-11-03T21:21:49.554+08:00",
    "traceId": "ebb7f4eb8c984e12",
    "data": {
        "contents": [
            {
                "avgApplicationWaitTime": 0.00,
                "avgBufferGets": 0.00,
                "avgConcurrencyWaitTime": 0.00,
                "avgCpuTime": 0.00,
                "avgDiskReads": 0.00,
                "avgDiskWrites": 0.00,
                "avgElapsedTime": 1.11,
                "avgRowProcessed": 7.65,
                "avgUserIoWaitTime": 0.00,
                "execPs": 4.63,
                "executions": 3,
                "tableScan": false,
                "timestamp": "2020-11-03T19:00:00.00Z"
            },
            {
                "avgApplicationWaitTime": 0.00,
                "avgBufferGets": 0.00,
                "avgConcurrencyWaitTime": 0.00,
                "avgCpuTime": 0.00,
                "avgDiskReads": 0.00,
                "avgDiskWrites": 0.00,
                "avgElapsedTime": 1.09,
                "avgRowProcessed": 7.69,
                "avgUserIoWaitTime": 0.00,
                "execPs": 4.63,
                "executions": 4,
                "tableScan": false,
                "timestamp": "2020-11-03T19:00:30Z"
            }
        ]
    }
}

```

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