查看慢日志明细 - 云数据库 RDS

说明本接口的返回参数每分钟更新一次。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeSlowLogRecords	系统规定参数。取值：DescribeSlowLogRecords。
DBInstanceId	String	是	rm-uf6wjk5******	实例ID。
SQLHASH	String	否	U2FsdGVk****	慢日志统计里的SQL语句唯一标识符，可用于获取该SQL语句的慢日志明细。
StartTime	String	是	2020-06-17T16:00Z	查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。
EndTime	String	是	2020-06-18T16:00Z	查询结束时间，需要大于查询开始时间，与查询开始时间间隔小于31天。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。
DBName	String	否	RDS_MySQL	数据库名称。
PageSize	Integer	否	30	每页记录数，取值：30~100。说明默认值：30。
PageNumber	Integer	否	1	页码，取值：大于0且不超过Integer的最大值。说明默认值：1。

返回数据


名称	类型	示例值	描述
PageRecordCount	Integer	1	本页SQL语句个数。
RequestId	String	4DBB1BB0-E5D8-4D41-B1C9-142364DB****	请求ID。
TotalRecordCount	Integer	1	总记录数。
DBInstanceId	String	rm-uf6wjk5*******	实例ID。
Engine	String	MySQL	数据库类型。
PageNumber	Integer	1	页码。
Items	Array of SQLSlowRecord		慢日志明细列表。
SQLSlowRecord
HostAddress	String	xxx[xxx] @ [1xx.xxx.xxx.xx]	连接数据库的客户端名称及地址。
RowsAffectedCount	Long	34	影响行数。说明仅SQL Server实例支持。
QueryTimes	Long	2	执行时长。单位：秒（s）。
SQLText	String	select sleep(2)	SQL命令详情。
CpuTime	Long	0.002	CPU处理时长。单位：毫秒（ms）。说明仅SQL Server实例支持。
QueryTimeMS	Long	2001	执行时长。单位：毫秒（ms）。
ApplicationName	String	example	连接的应用名称。说明仅SQL Server实例支持。
LockTimes	Long	0	锁定时长。单位：秒（s）。
ExecutionStartTime	String	2020-06-18T01:40:44Z	执行开始时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
LogicalIORead	Long	383	逻辑读次数。说明仅SQL Server实例支持。
WriteIOCount	Long	22	I/O写入次数。说明仅SQL Server实例支持。
PhysicalIORead	Long	200	物理读次数。说明仅SQL Server实例支持。
ReturnRowCounts	Long	1	返回行数。
ParseRowCounts	Long	1	解析行数。
DBName	String	testDB	数据库名称。
ClientHostName	String	example	客户端主机名。说明仅SQL Server实例支持。
UserName	String	user	用户名。说明仅SQL Server实例支持。
LastRowsAffectedCount	Long	2	最后一条语句的影响行数。说明仅SQL Server实例支持。
SQLHash	String	U2FsdGVk****	慢日志明细里的SQL语句唯一标识符。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeSlowLogRecords
&DBInstanceId=rm-uf6wjk5*******
&StartTime=2020-06-17T16:00Z
&EndTime=2020-06-18T16:00Z
&<公共请求参数>

正常返回示例

XML格式

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

<DescribeSlowLogRecordsResponse>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>1</PageRecordCount>
    <RequestId>4DBB1BB0-E5D8-4D41-B1C9-142364DB****</RequestId>
    <DBInstanceId>rm-uf6wjk5*******</DBInstanceId>
    <PageNumber>1</PageNumber>
    <Items>
        <SQLSlowRecord>
            <QueryTimes>2</QueryTimes>
            <ExecutionStartTime>2020-07-20T02:03:10Z</ExecutionStartTime>
            <ReturnRowCounts>1</ReturnRowCounts>
            <LockTimes>0</LockTimes>
            <DBName>testDB</DBName>
            <ParseRowCounts>1</ParseRowCounts>
            <HostAddress>test1[test1] @  [100.xxx.xxx.xxx]</HostAddress>
            <QueryTimeMS>2000</QueryTimeMS>
            <SQLText>select sleep(2)</SQLText>
        </SQLSlowRecord>
    </Items>
    <Engine>MySQL</Engine>
</DescribeSlowLogRecordsResponse>

JSON格式

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

{
  "TotalRecordCount" : 1,
  "PageRecordCount" : 1,
  "RequestId" : "4DBB1BB0-E5D8-4D41-B1C9-142364DB****",
  "DBInstanceId" : "rm-uf6wjk5*******",
  "PageNumber" : 1,
  "Items" : {
    "SQLSlowRecord" : [ {
      "QueryTimes" : 2,
      "ExecutionStartTime" : "2020-07-20T02:03:10Z",
      "ReturnRowCounts" : 1,
      "LockTimes" : 0,
      "DBName" : "testDB",
      "ParseRowCounts" : 1,
      "HostAddress" : "test1[test1] @  [100.xxx.xxx.xxx]",
      "QueryTimeMS" : 2000,
      "SQLText" : "select sleep(2)"
    } ]
  },
  "Engine" : "MySQL"
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidSearchTimeRange	search time range cannot be longer than a month.	查询结束时间（参数名称：EndTime）与查询开始时间（参数名称：StartTime）的间隔应小于31天，请输入正确的相关参数。
400	IO.Exception	IO exception, retry later.	io异常。

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