调用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"
}

错误码

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