该接口用于查询慢 SQL 列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
oceanbase:DescribeOasSlowSQLList |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
OceanBase 集群 ID。 |
ob317v4uif**** |
| TenantId |
string |
是 |
租户 ID。 |
t4louaeei**** |
| StartTime |
string |
是 |
查看慢 SQL 历史参数的起始时间。 |
2023-04-12T04:38:38Z |
| EndTime |
string |
是 |
查询慢 SQL 参数的结束时间。 |
2023-04-12T05:38:38Z |
| DbName |
string |
否 |
数据库名称。 |
test_db |
| SearchKeyWord |
string |
否 |
查询关键字。 |
update |
| SearchParam |
string |
否 |
查询参数。 |
cputime |
| SearchRule |
string |
否 |
查询规则。 |
> |
| SearchValue |
string |
否 |
查询值。 |
0.01 |
| SqlId |
string |
否 |
SQL ID。 |
8D6E84****0B8FB1823D199E2CA1**** |
| NodeIp |
string |
否 |
数据库节点 IP。 |
i-bp18qljorblo8es***** |
| FilterCondition |
string |
否 |
所有字段通过 @ 来引用。可选字段请参考查询 SQL 的性能统计接口返回的所有列。 |
@avgCpuTime > 20 and @executions > 100 |
| AcceptLanguage |
string |
否 |
返回数据的语言。 |
zh-CN |
| SqlTextLength |
integer |
否 |
返回 SQL 文本的最大长度。 |
65535 |
| DynamicSql |
boolean |
否 |
是否动态 SQL。 说明
|
false |
| MergeDynamicSql |
boolean |
否 |
返回结果时，是否合并动态 SQL。 说明
|
true |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
请求的返回结果。 |
||
| RequestId |
string |
请求 ID。 |
EE205C00-30E4-****-****-87E3A8A2AA0C |
| Data |
array<object> |
慢 SQL 信息列表。 |
|
|
array<object> |
慢 SQL 信息。 |
||
| Executions |
integer |
SQL 执行次数。 |
100 |
| RpcCount |
number |
期间的 RPC 次数。 |
0 |
| RemotePlans |
integer |
期间的远程执行次数。 |
0 |
| MissPlans |
integer |
期间未命中执行计划的次数。 |
0 |
| MaxElapsedTime |
number |
期间最大响应时间。 |
260.044 |
| TotalWaitTime |
number |
期间总等待时间。 |
10.966 |
| ExecPs |
number |
期间的平均每秒执行次数。 |
0.31 |
| MaxCpuTime |
number |
最大 CPU 时间。 |
257.967 |
| ClientIp |
string |
客户端 IP。 |
1*2.***.1*3.*** |
| UserName |
string |
用户名。 |
test_user |
| DbName |
string |
数据库名。 |
test_db |
| RetCode4012Count |
integer |
错误码 4012 出现次数。 |
0 |
| RetCode4013Count |
integer |
错误码 4013 出现次数。 |
0 |
| RetCode5001Count |
integer |
错误码 5001 出现次数。 |
0 |
| RetCode5024Count |
integer |
错误码 5024 出现次数。 |
0 |
| RetCode5167Count |
integer |
错误码 5167 出现次数。 |
0 |
| RetCode5217Count |
integer |
错误码 5217 出现次数。 |
0 |
| RetCode6002Count |
integer |
错误码 6002 出现次数。 |
0 |
| FailPercentage |
number |
SQL 执行错误率。 |
0.0 |
| SumWaitTime |
number |
SQL 最大等待事件的等待时间（毫秒）。 |
9421.73 |
| AvgWaitCount |
number |
SQL 平均等待次数。 |
0.0 |
| AvgRpcCount |
number |
SQL 平均 RPC 次数。 |
8.0 |
| LocalPlanPercentage |
number |
SQL Local 计划比例。 |
0.0 |
| RemotePlanPercentage |
number |
SQL Remote 计划比例。 |
0.0 |
| DistPlanPercentage |
number |
SQLDistributed 计划比例。 |
100.0 |
| SumElapsedTime |
number |
SQL 总响应时间（毫秒）。 |
11452126.36 |
| AvgNetTime |
number |
SQL 平均网络 IO 时间（毫秒）。 |
0.0 |
| AvgExecutorRpcCount |
number |
SQL 远程执行次数， 对应 v$sl_audit.executor_rpc。 |
0.0 |
| MissPlanPercentage |
number |
SQL 未命中计划比例。 |
0.0 |
| TableScanPercentage |
number |
SQL 全表扫描比率。 |
0.0 |
| StrongConsistencyPercentage |
number |
SQL 强读比例。 |
100.0 |
| WeakConsistencyPercentage |
number |
SQL 弱读比例。 |
0.0 |
| MaxAffectedRows |
number |
SQL 最大影响行数。 |
10000.0 |
| MaxReturnRows |
number |
SQL 最大返回行数。 |
0.0 |
| MaxWaitTime |
number |
SQL 最大等待时间（毫秒）。 |
3.4 |
| MaxApplicationWaitTime |
number |
SQL 最大应用等待时间（毫秒）。 |
0.0 |
| MaxConcurrencyWaitTime |
number |
SQL 最大并发等待时间（毫秒）。 |
0.0 |
| MaxUserIoWaitTime |
number |
SQL 最大 IO 等待时间（毫秒）。 |
0.0 |
| MaxDiskReads |
number |
最大磁盘读次数。 |
0.0 |
| AvgExpectedWorkerCount |
number |
预期并发数。 |
3 |
| AvgUsedWorkerCount |
number |
平均使用线程数。 |
3 |
| SumLogicalReads |
number |
总逻辑读。 |
0.0 |
| Server |
string |
OBServer |
i-bp1db1a**s038**mej** |
| ServerIp |
string |
OBServerIp |
i-bp1db1a**s038**mej** |
| ServerPort |
integer |
OBServer Port |
10110 |
| SqlTextShort |
string |
SQL 文本（前 100 字符）。 |
select a from b where |
| SqlType |
string |
SQL 类型。 |
select |
| SqlId |
string |
SQL ID。 |
8D6E84****0B8FB1823D199E2CA1**** |
| Inner |
boolean |
是否为内部 SQL。 |
false |
| WaitEvent |
string |
最长等待事件。 |
none |
| AvgAffectedRows |
number |
平均影响行数。 |
9978.75 |
| AvgReturnRows |
number |
平均返回行数。 |
0.0 |
| AvgPartitionCount |
number |
平均访问分区数。 |
1.0 |
| FailCount |
integer |
执行出错次数。 |
0 |
| AvgWaitTime |
number |
平均等待时间（毫秒）。 |
1.42 |
| AvgElapsedTime |
number |
平均响应时间（毫秒）。 |
1876.78 |
| AvgCpuTime |
number |
平均 CPU 时间（毫秒）。 |
1875.34 |
| AvgNetWaitTime |
number |
平均网络时间（毫秒）。 |
0.0 |
| AvgQueueTime |
number |
平均排队时间（毫秒）。 |
0.01 |
| AvgDecodeTime |
number |
平均解析时间（毫秒）。 |
0.0 |
| AvgGetPlanTime |
number |
获取执行计划的平均时间（毫秒）。 |
0.0 |
| AvgExecuteTime |
number |
SQL 平均执行时间（毫秒）。 |
1895.7 |
| AvgApplicationWaitTime |
number |
平均应用等待时间（毫秒）。 |
0.0 |
| AvgConcurrencyWaitTime |
number |
平均应用等待时间（毫秒）。 |
0.0 |
| AvgUserIoWaitTime |
number |
平均用户 IO 时间（毫秒）。 |
0.0 |
| AvgScheduleTime |
number |
平均调度时间（毫秒）。 |
0.0 |
| AvgRowCacheHit |
number |
平均 Row Cache 命中数。 |
0.0 |
| AvgBloomFilterCacheHit |
number |
平均 Bloom Filter Cache 命中数。 |
0.0 |
| AvgBlockCacheHit |
number |
平均 Block Cache 命中数。 |
0.0 |
| AvgBlockIndexCacheHit |
number |
平均 Block Index Cache 命中数。 |
0.0 |
| AvgDiskReads |
number |
平均磁盘读次数。 |
0.0 |
| RetryCount |
integer |
重试次数。 |
5 |
| AvgMemstoreReadRows |
number |
平均 Memstore 读行数。 |
0.0 |
| AvgSsstoreReadRows |
number |
平均 SSTable 读行数。 |
0.0 |
| AvgLogicalReads |
number |
平均逻辑读。 |
0.0 |
| DynamicSql |
boolean |
是否动态 SQL。 |
false |
| SqlList |
array<object> |
SQL 列表。 |
|
|
object |
返回结果。 |
||
| Executions |
integer |
期间的总执行次数。 |
100 |
| RpcCount |
number |
SQL 总 RPC 次数。 |
100 |
| RemotePlans |
integer |
SQL 远程执行次数。 |
100 |
| MissPlans |
integer |
SQL 未命中计划缓存次数。 |
100 |
| MaxElapsedTime |
number |
SQL 最大响应时间。 |
10000 |
| TotalWaitTime |
number |
SQL 执行时，总等待时间（单位：ms），对应 v$sql_audit.total_wait_time_micro（单位：us）。 |
100000 |
| ExecPs |
number |
SQL 执行频率。 |
0.31 |
| MaxCpuTime |
number |
SQL 最大 CPU 时间。 |
257.967 |
| ClientIp |
string |
客户端 IP。 |
127.0.0.1 |
| UserName |
string |
用户名。 |
admin |
| DbName |
string |
数据库名。 |
test |
| RetCode4012Count |
integer |
错误码 4012 出现次数。 |
0 |
| RetCode4013Count |
integer |
错误码 4013 出现次数。 |
0 |
| RetCode5001Count |
integer |
错误码 5001 出现次数。 |
0 |
| RetCode5024Count |
integer |
错误码 5024 出现次数。 |
0 |
| RetCode5167Count |
integer |
错误码 5167 出现次数。 |
0 |
| RetCode5217Count |
integer |
错误码 5217 出现次数。 |
0 |
| RetCode6002Count |
integer |
错误码 6002 出现次数。 |
0 |
| FailPercentage |
number |
SQL 执行错误率。 |
0 |
| SumWaitTime |
number |
SQL 最大等待事件的等待时间（毫秒）。 |
9421.73 |
| AvgWaitCount |
number |
SQL 平均等待时间（毫秒）。 |
0 |
| AvgRpcCount |
number |
SQL 平均 RPC 次数。 |
0 |
| LocalPlanPercentage |
number |
SQL Local 计划比例。 |
0 |
| RemotePlanPercentage |
number |
SQL Remote 计划比例。 |
0 |
| DistPlanPercentage |
number |
SQLDistributed 计划比例。 |
100 |
| SumElapsedTime |
number |
SQL 总响应时间（毫秒）。 |
11452126.36 |
| AvgNetTime |
number |
SQL 平均网络 IO 时间（毫秒）。 |
0 |
| AvgExecutorRpcCount |
number |
SQL 远程执行次数， 对应 v$sl_audit.executor_rpc。 |
0 |
| MissPlanPercentage |
number |
SQL 未命中计划比例。 |
0 |
| TableScanPercentage |
number |
SQL 全表扫描比率。 |
0 |
| StrongConsistencyPercentage |
number |
SQL 强读比例。 |
100 |
| WeakConsistencyPercentage |
number |
SQL 弱读比例。 |
0 |
| MaxAffectedRows |
number |
SQL 最大影响行数。 |
10000 |
| MaxReturnRows |
number |
SQL 最大返回行数。 |
0 |
| MaxWaitTime |
number |
SQL 最大等待时间（毫秒）。 |
3.4 |
| MaxApplicationWaitTime |
number |
SQL 最大应用等待时间（毫秒）。 |
0 |
| MaxConcurrencyWaitTime |
number |
SQL 最大并发等待时间（毫秒）。 |
0 |
| MaxUserIoWaitTime |
number |
SQL 最大 IO 等待时间（毫秒）。 |
0 |
| MaxDiskReads |
number |
最大磁盘读次数。 |
0 |
| AvgExpectedWorkerCount |
number |
预期并发数。 |
3 |
| AvgUsedWorkerCount |
number |
使用并发数。 |
3 |
| SumLogicalReads |
number |
总逻辑读。 |
0 |
| Server |
string |
OBServer |
10.**.**.6 |
| ServerIp |
string |
OBServer IP |
11.***.**.69 |
| ServerPort |
integer |
OBServer port |
389 |
| SqlTextShort |
string |
SQL 文本（前 100 字符）。 |
select * from test |
| SqlType |
string |
SQL 类型。 |
SELECT |
| SqlId |
string |
SQL ID |
4CE89****8536A03374DD2****E76DE5 |
| Inner |
boolean |
是否是内部 SQL。 |
false |
| WaitEvent |
string |
最长等待事件。 |
none |
| AvgAffectedRows |
number |
平均影响行数。 |
9978.75 |
| AvgReturnRows |
number |
平均返回行数。 |
0 |
| AvgPartitionCount |
number |
平均访问分区数。 |
1 |
| FailCount |
integer |
执行出错次数。 |
22 |
| AvgWaitTime |
number |
平均等待时间（毫秒）。 |
1.42 |
| AvgElapsedTime |
number |
平均响应时间（毫秒）。 |
1876.78 |
| AvgCpuTime |
number |
平均 CPU 时间（毫秒）。 |
@avgCpuTime > 20 and @executions > 100 |
| AvgNetWaitTime |
number |
平均网络时间（毫秒）。 |
0 |
| AvgQueueTime |
number |
平均排队时间（毫秒）。 |
0.01 |
| AvgDecodeTime |
number |
平均语法解析时间（毫秒）。 |
0 |
| AvgGetPlanTime |
number |
平均计划生成时间（毫秒）。 |
0 |
| AvgExecuteTime |
number |
平均计划执行时间（毫秒）。 |
1895.7 |
| AvgApplicationWaitTime |
number |
平均应用等待时间（毫秒）。 |
0 |
| AvgConcurrencyWaitTime |
number |
平均并发等待时间（毫秒） |
0 |
| AvgUserIoWaitTime |
number |
平均用户 IO 时间（毫秒）。 |
0 |
| AvgScheduleTime |
number |
平均调度时间（毫秒）。 |
0 |
| AvgRowCacheHit |
number |
平均 Row Cache 命中次数。 |
0 |
| AvgBloomFilterCacheHit |
number |
平均 Bloom Filter Cache 命中次数。 |
0 |
| AvgBlockCacheHit |
number |
平均 Block Cache 命中次数。 |
0 |
| AvgBlockIndexCacheHit |
number |
平均 Block Index Cache 命中次数。 |
0 |
| AvgDiskReads |
number |
平均磁盘读次数。 |
0 |
| RetryCount |
integer |
重试次数。 |
2 |
| AvgMemstoreReadRows |
number |
平均 Memstore 读行数。 |
0 |
| AvgSsstoreReadRows |
number |
平均 SSTable 读行数。 |
0 |
| AvgLogicalReads |
number |
平均逻辑读。 |
0 |
| AvgDbTime |
number |
平均数据库时间（毫秒）。 |
100 |
| SumDbTime |
number |
总数据库时间（毫秒）。 |
100 |
| FormatSqlId |
string |
FormatSqlId |
|
| AvgDbTime |
number |
平均数据库时间（毫秒）。 |
100 |
| SumDbTime |
number |
总数据库时间（毫秒）。 |
100 |
| FormatSqlId |
string |
FormatSqlId |
示例
正常返回示例
JSON格式
{
"RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
"Data": [
{
"Executions": 100,
"RpcCount": 0,
"RemotePlans": 0,
"MissPlans": 0,
"MaxElapsedTime": 260.044,
"TotalWaitTime": 10.966,
"ExecPs": 0.31,
"MaxCpuTime": 257.967,
"ClientIp": "1*2.***.1*3.***",
"UserName": "test_user",
"DbName": "test_db",
"RetCode4012Count": 0,
"RetCode4013Count": 0,
"RetCode5001Count": 0,
"RetCode5024Count": 0,
"RetCode5167Count": 0,
"RetCode5217Count": 0,
"RetCode6002Count": 0,
"FailPercentage": 0,
"SumWaitTime": 9421.73,
"AvgWaitCount": 0,
"AvgRpcCount": 8,
"LocalPlanPercentage": 0,
"RemotePlanPercentage": 0,
"DistPlanPercentage": 100,
"SumElapsedTime": 11452126.36,
"AvgNetTime": 0,
"AvgExecutorRpcCount": 0,
"MissPlanPercentage": 0,
"TableScanPercentage": 0,
"StrongConsistencyPercentage": 100,
"WeakConsistencyPercentage": 0,
"MaxAffectedRows": 10000,
"MaxReturnRows": 0,
"MaxWaitTime": 3.4,
"MaxApplicationWaitTime": 0,
"MaxConcurrencyWaitTime": 0,
"MaxUserIoWaitTime": 0,
"MaxDiskReads": 0,
"AvgExpectedWorkerCount": 3,
"AvgUsedWorkerCount": 3,
"SumLogicalReads": 0,
"Server": "i-bp1db1a**s038**mej**",
"ServerIp": "i-bp1db1a**s038**mej**",
"ServerPort": 10110,
"SqlTextShort": "select a from b where",
"SqlType": "select ",
"SqlId": "8D6E84****0B8FB1823D199E2CA1****",
"Inner": false,
"WaitEvent": "none",
"AvgAffectedRows": 9978.75,
"AvgReturnRows": 0,
"AvgPartitionCount": 1,
"FailCount": 0,
"AvgWaitTime": 1.42,
"AvgElapsedTime": 1876.78,
"AvgCpuTime": 1875.34,
"AvgNetWaitTime": 0,
"AvgQueueTime": 0.01,
"AvgDecodeTime": 0,
"AvgGetPlanTime": 0,
"AvgExecuteTime": 1895.7,
"AvgApplicationWaitTime": 0,
"AvgConcurrencyWaitTime": 0,
"AvgUserIoWaitTime": 0,
"AvgScheduleTime": 0,
"AvgRowCacheHit": 0,
"AvgBloomFilterCacheHit": 0,
"AvgBlockCacheHit": 0,
"AvgBlockIndexCacheHit": 0,
"AvgDiskReads": 0,
"RetryCount": 5,
"AvgMemstoreReadRows": 0,
"AvgSsstoreReadRows": 0,
"AvgLogicalReads": 0,
"DynamicSql": false,
"SqlList": [
{
"Executions": 100,
"RpcCount": 100,
"RemotePlans": 100,
"MissPlans": 100,
"MaxElapsedTime": 10000,
"TotalWaitTime": 100000,
"ExecPs": 0.31,
"MaxCpuTime": 257.967,
"ClientIp": "127.0.0.1",
"UserName": "admin",
"DbName": "test",
"RetCode4012Count": 0,
"RetCode4013Count": 0,
"RetCode5001Count": 0,
"RetCode5024Count": 0,
"RetCode5167Count": 0,
"RetCode5217Count": 0,
"RetCode6002Count": 0,
"FailPercentage": 0,
"SumWaitTime": 9421.73,
"AvgWaitCount": 0,
"AvgRpcCount": 0,
"LocalPlanPercentage": 0,
"RemotePlanPercentage": 0,
"DistPlanPercentage": 100,
"SumElapsedTime": 11452126.36,
"AvgNetTime": 0,
"AvgExecutorRpcCount": 0,
"MissPlanPercentage": 0,
"TableScanPercentage": 0,
"StrongConsistencyPercentage": 100,
"WeakConsistencyPercentage": 0,
"MaxAffectedRows": 10000,
"MaxReturnRows": 0,
"MaxWaitTime": 3.4,
"MaxApplicationWaitTime": 0,
"MaxConcurrencyWaitTime": 0,
"MaxUserIoWaitTime": 0,
"MaxDiskReads": 0,
"AvgExpectedWorkerCount": 3,
"AvgUsedWorkerCount": 3,
"SumLogicalReads": 0,
"Server": "10.**.**.6",
"ServerIp": "11.***.**.69",
"ServerPort": 389,
"SqlTextShort": "select * from test",
"SqlType": "SELECT",
"SqlId": "4CE89****8536A03374DD2****E76DE5",
"Inner": false,
"WaitEvent": "none",
"AvgAffectedRows": 9978.75,
"AvgReturnRows": 0,
"AvgPartitionCount": 1,
"FailCount": 22,
"AvgWaitTime": 1.42,
"AvgElapsedTime": 1876.78,
"AvgCpuTime": 0,
"AvgNetWaitTime": 0,
"AvgQueueTime": 0.01,
"AvgDecodeTime": 0,
"AvgGetPlanTime": 0,
"AvgExecuteTime": 1895.7,
"AvgApplicationWaitTime": 0,
"AvgConcurrencyWaitTime": 0,
"AvgUserIoWaitTime": 0,
"AvgScheduleTime": 0,
"AvgRowCacheHit": 0,
"AvgBloomFilterCacheHit": 0,
"AvgBlockCacheHit": 0,
"AvgBlockIndexCacheHit": 0,
"AvgDiskReads": 0,
"RetryCount": 2,
"AvgMemstoreReadRows": 0,
"AvgSsstoreReadRows": 0,
"AvgLogicalReads": 0,
"AvgDbTime": 100,
"SumDbTime": 100,
"FormatSqlId": ""
}
],
"AvgDbTime": 100,
"SumDbTime": 100,
"FormatSqlId": ""
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。