文档

DescribeOasSQLPlans - 查询 SQL 执行计划

更新时间:

根据 SQLID 查询诊断系统存储的 SQL 执行计划信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring

OceanBase 集群 ID。

ob317v4uif****
TenantIdstring

租户 ID。

t4louaeei****
StartTimestring

查询 SQL 执行计划的起始时间。

该时间只支持 UTC 时间,格式为:YYYY-MM-DDThh:mm:ssZ。

2023-04-12T04:38:38Z
EndTimestring

查询 SQL 执行计划的结束时间。
该时间只支持 UTC 时间,格式为:YYYY-MM-DDThh:mm:ssZ。

2023-04-12T05:38:38Z
DbNamestring

数据库名称。

test_db
SqlIdstring

SQL ID。

8D6E84****0B8FB1823D199E2CA1****
AcceptLanguagestring

支持的语言。取值:

  • 中文:zh-CN
  • 英文:en-US
zh-CN
DynamicSqlboolean

是否为动态 SQL。

false

返回参数

名称类型描述示例值
object

请求的返回结果。

RequestIdstring

请求 ID。

EE205C00-30E4-****-****-87E3A8A2AA0C
Dataarray<object>

SQL 执行计划信息列表。

object

SQL 执行计划信息。

PlanHashstring

SQL 执行计划在诊断系统内部的标识。

1758****24913166****
Plansarray<object>

执行计划列表。

object

请求的返回结果。

Uidstring

Plan 的唯一标识。

AAAAAAAAAAI****AAFoT2QAF--7W****
PlanIdlong

计划 ID。

590****
FirstLoadTimestring

Plan 首次被加载的时间。

2023-04-12T04:46:38Z
PlanTypestring

Plan 类型:LOCAL、REMOTE、DIST。

LOCAL
PlanHashstring

SQL 执行计划在诊断系统内部的标识。

-86290582****886880
PlanSizelong

计划大小。

10****
SchemaVersionlong

Schema 版本。

16838****3550464
MergedVersionlong

合并版本。

513
ObServerIdlong

server ID。

2
ObDbIdlong

数据库 ID。

11006****828
ServerIdlong

后端服务器实例 ID。

2
FirstLoadTimeUslong

首次加载时间。

1684****03289441
HitDiagnosisboolean

是否命中诊断。

false
OutlineDatastring

SQL 执行计划的 outline_data 字段。

/*+ BEGIN_OUTLINE_DATA INDEX(@\"SEL$1\
OutlineIdlong

Outline ID。

-1
CollectTimeUslong

收集时间。

1684368****00000
Serverstring

SQL 执行所在的 Server。

i-bp1db1a9us038****jio
HitPercentagedouble

命中率。

100.0
Executionslong

期间的总执行次数。

1
ExecPsdouble

期间的平均每秒执行次数。

0.31
AvgDiskReadsdouble

期间内的平均物理读次数。

0.0
AvgDiskWritesdouble

期间内的平均物理写入次数。

0.0
AvgBufferGetsdouble

计划在期间内的平均缓存读次数。

30137.03
AvgApplicationWaitTimedouble

期间内的平均 Application 事件等待时间(毫秒)。

0.0
AvgConcurrencyWaitTimedouble

期间内的平均 Concurrency 事件等待时间(毫秒)。

0.0
AvgUserIoWaitTimedouble

期间内的平均 UserIo 事件等待时间(毫秒)。

0.0
AvgRowProcesseddouble

期间内的平均行处理等待时间(毫秒)。

1.0
AvgElapsedTimedouble

期间内的平均间隔等待时间(毫秒)。

1876.78
AvgCpuTimedouble

期间内的平均 CPU 时间(毫秒)。

1875.34
LargeQueryPercentagedouble

长时间执行查询的完成百分比。

0.0
DelayedLargeQueryPercentagedouble

长时间执行查询的延迟百分比。

0.0
TimeoutPercentagedouble

超时百分比。

0.0
TableScanboolean

是否全表扫描。

false
PlanUnionHashstring

SQL 执行计划在诊断系统内部的唯一标识。

"52c7c53****53e61b3f7586b17****ad"
SqlIdstring

SQL ID。

46939C87ECA****95ED0FF64F44B****
MergedVersionlong

合并版本。

513
FirstLoadTimestring

首次加载时间

2023-04-12T04:46:38Z
PlanTypestring

执行计划类型。

LOCAL
HitDiagnosisboolean

是否命中诊断。

false
HitPercentagedouble

命中率。

100.0
AvgCpuTimedouble

期间内的平均 CPU 时间(毫秒)。

1875.34
PlanExplainobject

执行计划。

PlanJsonStringstring

SQL 执行计划的 JSON 字符串。

"PlanJsonString":"{\"RootOperations\":[{\"Children\":[{\"Children\":[{\"Cost\":2000,\"ObjectName\":\"TR\",\"Operator\":\"PHY_TABLE_SCAN\",\"Property\":\"table_rows:8593, physical_range_rows:85, logical_range_rows:85, index_back_rows:0, output_rows:85, est_method:default_stat, avaiable_index_name[ALL_VIRTUAL_AGENT]\",\"Rows\":86},{\"Children\":[{\"Cost\":2000,\"ObjectName\":\"NA\",\"Operator\":\"PHY_TABLE_SCAN\",\"Property\":\"table_rows:1750, physical_range_rows:17, logical_range_rows:17, index_back_rows:0, output_rows:17, est_method:default_stat, avaiable_index_name[ALL_VIRTUAL_AGENT]\",\"Rows\":18}],\"Cost\":2013,\"ObjectName\":\"NULL\",\"Operator\":\"PHY_SORT\",\"Property\":\"NULL\",\"Rows\":18}],\"Cost\":4024,\"ObjectName\":\"NULL\",\"Operator\":\"PHY_MERGE_JOIN\",\"Property\":\"NULL\",\"Rows\":26}],\"Cost\":4025,\"ObjectName\":\"NULL\",\"Operator\":\"PHY_SCALAR_AGGREGATE\",\"Property\":\"NULL\",\"Rows\":1}]}"
Executionslong

执行次数。

1
PlanUnionHashstring

SQL 执行计划在诊断系统内部的唯一标识。

"52c7c53****53e61b3f7586b17****ad"
QuerySqlstring

查询语句。

说明
暂未使用,恒为空。
"select 1 from t"
Boundedboolean

是否绑定该执行计划。

false

示例

正常返回示例

JSON格式

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": [
    {
      "PlanHash": "1758****24913166****",
      "Plans": [
        {
          "Uid": "AAAAAAAAAAI****AAFoT2QAF--7W****",
          "PlanId": 0,
          "FirstLoadTime": "2023-04-12T04:46:38Z",
          "PlanType": "LOCAL",
          "PlanHash": "-86290582****886880",
          "PlanSize": 0,
          "SchemaVersion": 0,
          "MergedVersion": 513,
          "ObServerId": 2,
          "ObDbId": 0,
          "ServerId": 2,
          "FirstLoadTimeUs": 0,
          "HitDiagnosis": false,
          "OutlineData": "/*+ BEGIN_OUTLINE_DATA INDEX(@\\\"SEL$1\\",
          "OutlineId": -1,
          "CollectTimeUs": 0,
          "Server": "i-bp1db1a9us038****jio",
          "HitPercentage": 100,
          "Executions": 1,
          "ExecPs": 0.31,
          "AvgDiskReads": 0,
          "AvgDiskWrites": 0,
          "AvgBufferGets": 30137.03,
          "AvgApplicationWaitTime": 0,
          "AvgConcurrencyWaitTime": 0,
          "AvgUserIoWaitTime": 0,
          "AvgRowProcessed": 1,
          "AvgElapsedTime": 1876.78,
          "AvgCpuTime": 1875.34,
          "LargeQueryPercentage": 0,
          "DelayedLargeQueryPercentage": 0,
          "TimeoutPercentage": 0,
          "TableScan": false,
          "PlanUnionHash": "\"52c7c53****53e61b3f7586b17****ad\"",
          "SqlId": "46939C87ECA****95ED0FF64F44B****"
        }
      ],
      "MergedVersion": 513,
      "FirstLoadTime": "2023-04-12T04:46:38Z",
      "PlanType": "LOCAL",
      "HitDiagnosis": false,
      "HitPercentage": 100,
      "AvgCpuTime": 1875.34,
      "PlanExplain": {
        "PlanJsonString": "\"PlanJsonString\":\"{\\\"RootOperations\\\":[{\\\"Children\\\":[{\\\"Children\\\":[{\\\"Cost\\\":2000,\\\"ObjectName\\\":\\\"TR\\\",\\\"Operator\\\":\\\"PHY_TABLE_SCAN\\\",\\\"Property\\\":\\\"table_rows:8593, physical_range_rows:85, logical_range_rows:85, index_back_rows:0, output_rows:85, est_method:default_stat, avaiable_index_name[ALL_VIRTUAL_AGENT]\\\",\\\"Rows\\\":86},{\\\"Children\\\":[{\\\"Cost\\\":2000,\\\"ObjectName\\\":\\\"NA\\\",\\\"Operator\\\":\\\"PHY_TABLE_SCAN\\\",\\\"Property\\\":\\\"table_rows:1750, physical_range_rows:17, logical_range_rows:17, index_back_rows:0, output_rows:17, est_method:default_stat, avaiable_index_name[ALL_VIRTUAL_AGENT]\\\",\\\"Rows\\\":18}],\\\"Cost\\\":2013,\\\"ObjectName\\\":\\\"NULL\\\",\\\"Operator\\\":\\\"PHY_SORT\\\",\\\"Property\\\":\\\"NULL\\\",\\\"Rows\\\":18}],\\\"Cost\\\":4024,\\\"ObjectName\\\":\\\"NULL\\\",\\\"Operator\\\":\\\"PHY_MERGE_JOIN\\\",\\\"Property\\\":\\\"NULL\\\",\\\"Rows\\\":26}],\\\"Cost\\\":4025,\\\"ObjectName\\\":\\\"NULL\\\",\\\"Operator\\\":\\\"PHY_SCALAR_AGGREGATE\\\",\\\"Property\\\":\\\"NULL\\\",\\\"Rows\\\":1}]}\""
      },
      "Executions": 1,
      "PlanUnionHash": "\"52c7c53****53e61b3f7586b17****ad\"",
      "QuerySql": "\"select 1 from t\"",
      "Bounded": false
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-04-15OpenAPI 入参发生变更查看变更详情
2023-08-21OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情