查看慢日志明细 - 云数据库 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>
    <PageRecordCount>1</PageRecordCount>
    <RequestId>4DBB1BB0-E5D8-4D41-B1C9-142364DB****</RequestId>
    <TotalRecordCount>1</TotalRecordCount>
    <DBInstanceId>rm-uf6wjk5*******</DBInstanceId>
    <Engine>MySQL</Engine>
    <PageNumber>1</PageNumber>
    <Items>
        <HostAddress>xxx[xxx] @  [1xx.xxx.xxx.xx]</HostAddress>
        <RowsAffectedCount>34</RowsAffectedCount>
        <QueryTimes>2</QueryTimes>
        <SQLText>select sleep(2)</SQLText>
        <QueryTimeMS>2001</QueryTimeMS>
        <ApplicationName>example</ApplicationName>
        <LockTimes>0</LockTimes>
        <ExecutionStartTime>2020-06-18T01:40:44Z</ExecutionStartTime>
        <LogicalIORead>383</LogicalIORead>
        <WriteIOCount>22</WriteIOCount>
        <PhysicalIORead>200</PhysicalIORead>
        <ReturnRowCounts>1</ReturnRowCounts>
        <ParseRowCounts>1</ParseRowCounts>
        <DBName>testDB</DBName>
        <ClientHostName>example</ClientHostName>
        <UserName>user</UserName>
        <LastRowsAffectedCount>2</LastRowsAffectedCount>
        <SQLHash>U2FsdGVk****</SQLHash>
    </Items>
</DescribeSlowLogRecordsResponse>

JSON格式

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

{
  "PageRecordCount" : 1,
  "RequestId" : "4DBB1BB0-E5D8-4D41-B1C9-142364DB****",
  "TotalRecordCount" : 1,
  "DBInstanceId" : "rm-uf6wjk5*******",
  "Engine" : "MySQL",
  "PageNumber" : 1,
  "Items" : [ {
    "HostAddress" : "xxx[xxx] @  [1xx.xxx.xxx.xx]",
    "RowsAffectedCount" : 34,
    "QueryTimes" : 2,
    "SQLText" : "select sleep(2)",
    "QueryTimeMS" : 2001,
    "ApplicationName" : "example",
    "LockTimes" : 0,
    "ExecutionStartTime" : "2020-06-18T01:40:44Z",
    "LogicalIORead" : 383,
    "WriteIOCount" : 22,
    "PhysicalIORead" : 200,
    "ReturnRowCounts" : 1,
    "ParseRowCounts" : 1,
    "DBName" : "testDB",
    "ClientHostName" : "example",
    "UserName" : "user",
    "LastRowsAffectedCount" : 2,
    "SQLHash" : "U2FsdGVk****"
  } ]
}

错误码


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

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