调用DescribeSlowLogRecords接口查看PolarDB集群的慢日志明细。

仅PolarDB MySQL 5.6、5.7或8.0集群支持调用该接口。

调试

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

请求参数

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

系统规定参数，取值：DescribeSlowLogRecords。

DBClusterId String 是 pc-************

集群ID。
RegionId String 是 cn-hangzhou

地域ID。

说明 可通过接口DescribeRegions查看可用的地域。
StartTime String 是 2020-11-12T16:00Z

查询开始时间。格式为yyyy-MM-dd</i>T<i>HH:mmZ（UTC时间）。

EndTime String 是 2020-11-13T09:00Z

查询结束时间，需要晚于查询开始时间，与查询开始时间间隔小于31天。格式为yyyy-MM-dd</i>T<i>HH:mmZ（UTC时间）。

DBName String 否 testdb

数据库名称。
PageSize Integer 否 30

每页记录数，取值范围如下：

  • 30
  • 50
  • 100

默认值为30。

PageNumber Integer 否 1

页码，取值范围为大于0且不超过Integer的最大值。

默认值为1。

SQLHASH String 否 U2FsdGVk****

慢日志统计里的SQL语句唯一标识符，可用于获取该SQL语句的慢日志明细。

返回数据

名称 类型 示例值 描述
Items Array of SQLSlowRecord

慢日志明细列表。
SQLSlowRecord
DBName String test_db

数据库名称。
DBNodeId String pi-*****************

节点ID。
ExecutionStartTime String 2020-11-13T08:05:24Z

SQL开始执行的时间。格式为yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

HostAddress String testdb[testdb] @ [100.**.**.242]

连接数据库的客户端地址。
LockTimes Long 0

SQL锁定时长，单位为秒。
ParseRowCounts Long 0

解析行数。
QueryTimes Long 20

SQL执行时长，单位为秒。
ReturnRowCounts Long 0

返回行数。
SQLText String /* Query from *** by user 111 */ SELECT sleep(20)

查询语句。
TotalRecordCount Integer 1

总SQL语句个数。
PageNumber Integer 1

页码。
RequestId String C77EF623-844B-48A1-A3B9-78F841******

请求ID。
DBClusterId String pc-*****************

集群ID。
Engine String polardb_mysql

数据库引擎。
PageRecordCount Integer 1

本页记录数。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=DescribeSlowLogRecords
&DBClusterId=pc-************
&RegionId=cn-hangzhou
&StartTime=2019-11-18T16:00Z
&EndTime=2019-12-18T16:00Z
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeSlowLogRecordsResponse>
  <TotalRecordCount>1</TotalRecordCount>
  <PageRecordCount>1</PageRecordCount>
  <RequestId>C77EF623-844B-48A1-A3B9-78F841******</RequestId>
  <PageNumber>1</PageNumber>
  <DBClusterId>pc-*****************</DBClusterId>
  <Items>
        <SQLSlowRecord>
              <QueryTimes>20</QueryTimes>
              <ExecutionStartTime>2020-11-13T08:05:24Z</ExecutionStartTime>
              <ReturnRowCounts>1</ReturnRowCounts>
              <LockTimes>0</LockTimes>
              <DBName>test_db</DBName>
              <ParseRowCounts>0</ParseRowCounts>
              <DBNodeId>pi-*****************</DBNodeId>
              <HostAddress>test_api[test_api] @  [100.***.***.***]</HostAddress>
              <SQLText>/* Query from *** by user 111 */ SELECT sleep(20)</SQLText>
        </SQLSlowRecord>
  </Items>
  <Engine>polardb_mysql</Engine>
</DescribeSlowLogRecordsResponse>

JSON 格式 

{
	"TotalRecordCount": 1,
	"PageRecordCount": 1,
	"RequestId": "C77EF623-844B-48A1-A3B9-78F841******",
	"PageNumber": 1,
	"DBClusterId": "pc-*****************",
	"Items": {
		"SQLSlowRecord": [
			{
				"QueryTimes": 20,
				"ExecutionStartTime": "2020-11-13T08:05:24Z",
				"ReturnRowCounts": 1,
				"LockTimes": 0,
				"DBName": "test_db",
				"ParseRowCounts": 0,
				"DBNodeId": "pi-*****************",
				"HostAddress": "test_api[test_api] @  [100.***.***.***]",
				"SQLText": "/* Query from *** by user 111 */ SELECT sleep(20)"
			}
		]
	},
	"Engine": "polardb_mysql"
}

错误码

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