调用GetInstanceSqlOptimizeStatistic接口，获取指定时间段内自动SQL优化事件的统计数据，包括事件总数和最大收益。

使用该接口需满足以下前提条件：

  • 使用阿里云或DAS的SDK时，建议使用最新版本。
  • 使用SDK调用DAS服务时，需要将地域指定为cn-shanghai。
  • 数据库引擎为RDS MySQL或PolarDB MySQL。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 GetInstanceSqlOptimizeStatistic

系统规定参数。取值：GetInstanceSqlOptimizeStatistic。

InstanceId String 是 pc-wz90h9560rvdz****

数据库实例ID。

说明 仅支持RDS MySQL、PolarDB MySQL数据库实例。
StartTime String 是 1661308902060

查询开始时间，格式为Unix时间戳（UTC时间），单位为毫秒。
EndTime String 是 1662518540764

查询结束时间，格式为Unix时间戳（UTC时间），单位为毫秒。
NodeId String 否 pi-bp12v7243x012****

节点ID。

说明 对于RDS MySQL集群版数据库实例或PolarDB MySQL数据库实例，需要提供节点ID。
Threshold String 否 None

自动SQL优化事件的持续时间阈值。

设置此参数后，只会统计持续时间不超过阈值的自动SQL优化事件。

说明 此参数为备用参数，当前暂不生效。
FilterEnable String 否 false

是否过滤开启了DAS专业版的数据库实例：

  • true：是。
  • false：否。
说明 取值为true时，只统计未开启DAS专业版的数据库实例；取值为false时，统计所有数据库实例。
UseMerging String 否 true

是否合并事件：

  • true：是。
  • false：否。
说明 此参数为备用参数，当前暂不生效。

返回数据

名称 类型 示例值 描述
Code String 200

返回的状态码。
Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful，请求失败时会返回请求异常信息（如错误码等）。
Data Object

详细信息列表。
count Integer 16

自动SQL优化事件总数。
improvement double 1003

返回的自动SQL优化事件中，SQL优化后的最大收益倍数。
RequestId String B6D17591-B48B-4D31-9CD6-9B9796B2****

请求ID。
Success String true

请求是否执行成功：

  • true：执行成功。
  • false：执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetInstanceSqlOptimizeStatistic
&InstanceId=pc-wz90h9560rvdz****
&StartTime=1661308902060
&EndTime=1662518540764
&NodeId=pi-bp12v7243x012****
&FilterEnable=false
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<GetInstanceSqlOptimizeStatisticResponse>
    <Code>200</Code>
    <Message>Successful</Message>
    <Data>
        <count>16</count>
        <improvement>1003</improvement>
    </Data>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Success>true</Success>
</GetInstanceSqlOptimizeStatisticResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Code" : "200",
  "Message" : "Successful",
  "Data" : {
    "count" : 16,
    "improvement" : 1003
  },
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success" : "true"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The request parameters are invalid. 请求参数错误

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