文档

DescribeOasSlowSQLList - 查询慢 SQL 列表

更新时间:

该接口用于查询慢 SQL 列表。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
oceanbase:DescribeOasSlowSQLListRead
  • 全部资源
    *

请求参数

名称类型必填描述示例值
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
SearchKeyWordstring

查询关键字。

update
SearchParamstring

查询参数。

cputime
SearchRulestring

查询规则。

>
SearchValuestring

查询值。

0.01
SqlIdstring

SQL ID。

8D6E84****0B8FB1823D199E2CA1****
NodeIpstring

数据库节点 IP。

i-bp18qljorblo8es*****
FilterConditionstring

所有字段通过 @ 来引用。可选字段请参考查询 SQL 的性能统计接口返回的所有列。

@avgCpuTime > 20 and @executions > 100
AcceptLanguagestring

返回数据的语言。

zh-CN
SqlTextLengthlong

返回 SQL 文本的最大长度。

65535
DynamicSqlboolean

是否动态 SQL。

说明
表示传入的 SQL ID 是否为动态 SQL 的 ID。
false
MergeDynamicSqlboolean

返回结果时,是否合并动态 SQL。

说明
表示输出结果时,是否聚合 in 查询的 SQL 的结果。
true

返回参数

名称类型描述示例值
object

请求的返回结果。

RequestIdstring

请求 ID。

EE205C00-30E4-****-****-87E3A8A2AA0C
Dataobject []

慢 SQL 信息列表。

Executionsdouble

SQL 执行次数。

100
RpcCountdouble

期间的 RPC 次数。

0
RemotePlansdouble

期间的远程执行次数。

0
MissPlansdouble

期间未命中执行计划的次数。

0
MaxElapsedTimedouble

期间最大响应时间。

260.044
TotalWaitTimedouble

期间总等待时间。

10.966
ExecPsdouble

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

0.31
MaxCpuTimedouble

最大 CPU 时间。

257.967
ClientIpstring

客户端 IP。

1*2.***.1*3.***
UserNamestring

用户名。

test_user
DbNamestring

数据库名。

test_db
RetCode4012Countdouble

错误码 4012 出现次数。

0
RetCode4013Countdouble

错误码 4013 出现次数。

0
RetCode5001Countdouble

错误码 5001 出现次数。

0
RetCode5024Countdouble

错误码 5024 出现次数。

0
RetCode5167Countdouble

错误码 5167 出现次数。

0
RetCode5217Countdouble

错误码 5217 出现次数。

0
RetCode6002Countdouble

错误码 6002 出现次数。

0
FailPercentagedouble

SQL 执行错误率。

0.0
SumWaitTimedouble

SQL 最大等待事件的等待时间(毫秒)。

9421.73
AvgWaitCountdouble

SQL 平均等待次数。

0.0
AvgRpcCountdouble

SQL 平均 RPC 次数。

8.0
LocalPlanPercentagedouble

SQL Local 计划比例。

0.0
RemotePlanPercentagedouble

SQL Remote 计划比例。

0.0
DistPlanPercentagedouble

SQLDistributed 计划比例。

100.0
SumElapsedTimedouble

SQL 总响应时间(毫秒)。

11452126.36
AvgNetTimedouble

SQL 平均网络 IO 时间(毫秒)。

0.0
AvgExecutorRpcCountdouble

SQL 远程执行次数, 对应 v$sl_audit.executor_rpc。

0.0
MissPlanPercentagedouble

SQL 未命中计划比例。

0.0
TableScanPercentagedouble

SQL 全表扫描比率。

0.0
StrongConsistencyPercentagedouble

SQL 强读比例。

100.0
WeakConsistencyPercentagedouble

SQL 弱读比例。

0.0
MaxAffectedRowsdouble

SQL 最大影响行数。

10000.0
MaxReturnRowsdouble

SQL 最大返回行数。

0.0
MaxWaitTimedouble

SQL 最大等待时间(毫秒)。

3.4
MaxApplicationWaitTimedouble

SQL 最大应用等待时间(毫秒)。

0.0
MaxConcurrencyWaitTimedouble

SQL 最大并发等待时间(毫秒)。

0.0
MaxUserIoWaitTimedouble

SQL 最大 IO 等待时间(毫秒)。

0.0
MaxDiskReadsdouble

最大磁盘读次数。

0.0
AvgExpectedWorkerCountdouble

预期并发数。

3
AvgUsedWorkerCountdouble

平均使用线程数。

3
SumLogicalReadsdouble

总逻辑读。

0.0
Serverstring

OBServer

i-bp1db1a**s038**mej**
ServerIpstring

OBServerIp

i-bp1db1a**s038**mej**
ServerPortlong

OBServer Port

10110
SqlTextShortstring

SQL 文本(前 100 字符)。

select a from b where
SqlTypestring

SQL 类型。

select
SqlIdstring

SQL ID。

8D6E84****0B8FB1823D199E2CA1****
Innerboolean

是否为内部 SQL。

false
WaitEventstring

最长等待事件。

none
AvgAffectedRowsdouble

平均影响行数。

9978.75
AvgReturnRowsdouble

平均返回行数。

0.0
AvgPartitionCountdouble

平均访问分区数。

1.0
FailCountdouble

执行出错次数。

0
AvgWaitTimedouble

平均等待时间(毫秒)。

1.42
AvgElapsedTimedouble

平均响应时间(毫秒)。

1876.78
AvgCpuTimedouble

平均 CPU 时间(毫秒)。

1875.34
AvgNetWaitTimedouble

平均网络时间(毫秒)。

0.0
AvgQueueTimedouble

平均排队时间(毫秒)。

0.01
AvgDecodeTimedouble

平均解析时间(毫秒)。

0.0
AvgGetPlanTimedouble

获取执行计划的平均时间(毫秒)。

0.0
AvgExecuteTimedouble

SQL 平均执行时间(毫秒)。

1895.7
AvgApplicationWaitTimedouble

平均应用等待时间(毫秒)。

0.0
AvgConcurrencyWaitTimedouble

平均应用等待时间(毫秒)。

0.0
AvgUserIoWaitTimedouble

平均用户 IO 时间(毫秒)。

0.0
AvgScheduleTimedouble

平均调度时间(毫秒)。

0.0
AvgRowCacheHitdouble

平均 Row Cache 命中数。

0.0
AvgBloomFilterCacheHitdouble

平均 Bloom Filter Cache 命中数。

0.0
AvgBlockCacheHitdouble

平均 Block Cache 命中数。

0.0
AvgBlockIndexCacheHitdouble

平均 Block Index Cache 命中数。

0.0
AvgDiskReadsdouble

平均磁盘读次数。

0.0
RetryCountdouble

重试次数。

5
AvgMemstoreReadRowsdouble

平均 Memstore 读行数。

0.0
AvgSsstoreReadRowsdouble

平均 SSTable 读行数。

0.0
AvgLogicalReadsdouble

平均逻辑读。

0.0
DynamicSqlboolean

是否动态 SQL。

false
SqlListobject []

SQL 列表。

Executionsdouble

期间的总执行次数。

100
RpcCountdouble

SQL 总 RPC 次数。

100
RemotePlansdouble

SQL 远程执行次数。

100
MissPlansdouble

SQL 未命中计划缓存次数。

100
MaxElapsedTimedouble

SQL 最大响应时间。

10000
TotalWaitTimedouble

SQL 执行时,总等待时间(单位:ms),对应 v$sql_audit.total_wait_time_micro(单位:us)。

100000
ExecPsdouble

SQL 执行频率。

0.31
MaxCpuTimedouble

SQL 最大 CPU 时间。

257.967
ClientIpstring

客户端 IP。

127.0.0.1
UserNamestring

用户名。

admin
DbNamestring

数据库名。

test
RetCode4012Countlong

错误码 4012 出现次数。

0
RetCode4013Countlong

错误码 4013 出现次数。

0
RetCode5001Countlong

错误码 5001 出现次数。

0
RetCode5024Countlong

错误码 5024 出现次数。

0
RetCode5167Countlong

错误码 5167 出现次数。

0
RetCode5217Countlong

错误码 5217 出现次数。

0
RetCode6002Countlong

错误码 6002 出现次数。

0
FailPercentagedouble

SQL 执行错误率。

0
SumWaitTimedouble

SQL 最大等待事件的等待时间(毫秒)。

9421.73
AvgWaitCountdouble

SQL 平均等待时间(毫秒)。

0
AvgRpcCountdouble

SQL 平均 RPC 次数。

0
LocalPlanPercentagedouble

SQL Local 计划比例。

0
RemotePlanPercentagedouble

SQL Remote 计划比例。

0
DistPlanPercentagedouble

SQLDistributed 计划比例。

100
SumElapsedTimedouble

SQL 总响应时间(毫秒)。

11452126.36
AvgNetTimedouble

SQL 平均网络 IO 时间(毫秒)。

0
AvgExecutorRpcCountdouble

SQL 远程执行次数, 对应 v$sl_audit.executor_rpc。

0
MissPlanPercentagedouble

SQL 未命中计划比例。

0
TableScanPercentagedouble

SQL 全表扫描比率。

0
StrongConsistencyPercentagedouble

SQL 强读比例。

100
WeakConsistencyPercentagedouble

SQL 弱读比例。

0
MaxAffectedRowsdouble

SQL 最大影响行数。

10000
MaxReturnRowsdouble

SQL 最大返回行数。

0
MaxWaitTimedouble

SQL 最大等待时间(毫秒)。

3.4
MaxApplicationWaitTimedouble

SQL 最大应用等待时间(毫秒)。

0
MaxConcurrencyWaitTimedouble

SQL 最大并发等待时间(毫秒)。

0
MaxUserIoWaitTimedouble

SQL 最大 IO 等待时间(毫秒)。

0
MaxDiskReadsdouble

最大磁盘读次数。

0
AvgExpectedWorkerCountdouble

预期并发数。

3
AvgUsedWorkerCountdouble

使用并发数。

3
SumLogicalReadsdouble

总逻辑读。

0
Serverstring

OBServer

10.**.**.6
ServerIpstring

OBServer IP

11.***.**.69
ServerPortlong

OBServer port

389
SqlTextShortstring

SQL 文本(前 100 字符)。

select * from test
SqlTypestring

SQL 类型。

SELECT
SqlIdstring

SQL ID

4CE89****8536A03374DD2****E76DE5
Innerboolean

是否是内部 SQL。

false
WaitEventstring

最长等待事件。

none
AvgAffectedRowsdouble

平均影响行数。

9978.75
AvgReturnRowsdouble

平均返回行数。

0
AvgPartitionCountdouble

平均访问分区数。

1
FailCountdouble

执行出错次数。

22
AvgWaitTimedouble

平均等待时间(毫秒)。

1.42
AvgElapsedTimedouble

平均响应时间(毫秒)。

1876.78
AvgCpuTimedouble

平均 CPU 时间(毫秒)。

@avgCpuTime > 20 and @executions > 100
AvgNetWaitTimedouble

平均网络时间(毫秒)。

0
AvgQueueTimedouble

平均排队时间(毫秒)。

0.01
AvgDecodeTimedouble

平均语法解析时间(毫秒)。

0
AvgGetPlanTimedouble

平均计划生成时间(毫秒)。

0
AvgExecuteTimedouble

平均计划执行时间(毫秒)。

1895.7
AvgApplicationWaitTimedouble

平均应用等待时间(毫秒)。

0
AvgConcurrencyWaitTimedouble

平均并发等待时间(毫秒)

0
AvgUserIoWaitTimedouble

平均用户 IO 时间(毫秒)。

0
AvgScheduleTimedouble

平均调度时间(毫秒)。

0
AvgRowCacheHitdouble

平均 Row Cache 命中次数。

0
AvgBloomFilterCacheHitdouble

平均 Bloom Filter Cache 命中次数。

0
AvgBlockCacheHitdouble

平均 Block Cache 命中次数。

0
AvgBlockIndexCacheHitdouble

平均 Block Index Cache 命中次数。

0
AvgDiskReadsdouble

平均磁盘读次数。

0
RetryCountdouble

重试次数。

2
AvgMemstoreReadRowsdouble

平均 Memstore 读行数。

0
AvgSsstoreReadRowsdouble

平均 SSTable 读行数。

0
AvgLogicalReadsdouble

平均逻辑读。

0
AvgDbTimedouble

平均数据库时间(毫秒)。

100
SumDbTimedouble

总数据库时间(毫秒)。

100
AvgDbTimedouble

平均数据库时间(毫秒)。

100
SumDbTimedouble

总数据库时间(毫秒)。

100

示例

正常返回示例

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
        }
      ],
      "AvgDbTime": 100,
      "SumDbTime": 100
    }
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-04-15OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
2023-08-21OpenAPI 入参发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:DynamicSql
    新增入参:MergeDynamicSql
出参OpenAPI 返回结构发生变更
  • 本页导读 (0)