相关文章推荐
聪明伶俐的水龙头  ·  python 等待函数 ...·  2 年前    · 
苦恼的地瓜  ·  使用docker ...·  2 年前    · 
会开车的小马驹  ·  jQuery Click Outside ...·  2 年前    · 
买醉的机器猫  ·  使用 Visual Studio ...·  2 年前    · 

调用DescribeSlowLogs查询慢日志统计情况。

接口说明

调用该接口时,实例必须为如下版本:

  • MySQL所有版本(MySQL 5.7基础版除外);
  • SQL Server 2008 R2;
  • MariaDB 10.3。
说明 慢日志统计非实时采集,可能会有6~8小时的延迟。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的 Action 元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用 全部资源 表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 访问级别 资源类型 条件关键字 关联操作
rds:DescribeSlowLogs READ
  • RDS
    acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}
  • rds:ResourceTag

请求参数

名称 类型 必填 描述 示例值
DBInstanceId string

实例ID。

rm-uf6wjk5xxxxxxx
StartTime string

查询开始日期,格式: yyyy-MM-dd Z(UTC时间)。

2011-05-01Z
EndTime string

查询结束日期,不能小于查询开始日期,与查询开始日期间隔不超过31天。格式: yyyy-MM-dd Z(UTC时间)。

2011-05-30Z
DBName string

数据库名称。

RDS_MySQL
SortKey string

排序依据,取值:

  • TotalExecutionCounts :总执行次数最多
  • TotalQueryTimes :总执行时间最多
  • TotalLogicalReads :总逻辑读最多
  • TotalPhysicalReads :总物理读最多
说明 仅SQL Server 2008 R2实例支持本参数。
TotalExecutionCounts
PageSize integer

每页记录数,取值: 30 ~ 100 。默认值: 30

30
PageNumber integer

页码,取值:大于0且不超过Integer的最大值。

默认值: 1

1

返回参数

名称 类型 描述 示例值
object
EndTime string

查询结束日期。

2011-05-30Z
StartTime string

查询开始日期。

2011-05-30Z
RequestId string

请求ID。

2553A660-E4EB-4AF4-A402-8AFF70A49143
PageRecordCount integer

本页SQL语句个数。

10
TotalRecordCount integer

总记录数。

5
DBInstanceId string

实例ID。

rm-uf6wjk5xxxxxxx
PageNumber integer

页码。

1
Engine string

数据库类型。

MySQL
Items array

慢日志信息列表。

object
MaxLastRowsAffectedCounts long

最后一次受影响的行数(最大值)。

说明 仅SQL Server实例支持返回该参数。
0
ReturnMaxRowCount long

返回的SQL行数(最大值)。

1
SQLText string

SQL语句。

select id,name from tb_table
SQLServerMaxCpuTime long

CPU查询时间(最大值),单位:秒。

说明 仅SQL Server实例支持返回该参数。
0
CreateTime string

数据生成日期。

2011-05-30Z
AvgLastRowsAffectedCounts long

最后一次受影响的行数(平均值)。

说明 仅SQL Server实例支持返回该参数。
0
MinLastRowsAffectedCounts long

最后一次受影响的行数(最小值)。

说明 仅SQL Server实例支持返回该参数。
0
ParseTotalRowCounts long

解析的SQL行数(总值)。

1
TotalLockTimes long

锁定时长(总值),单位:秒。

0
MySQLTotalExecutionCounts long

MySQL执行次数(总值)。

1
SQLServerMinCpuTime long

CPU查询时间(最小值),单位:秒。

说明 仅SQL Server实例支持返回该参数。
0
SQLHASH string

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

U2FsdGVkxxxx
MinIOWriteCounts long

I/O写次数(最小值)。

说明 仅SQL Server实例支持返回该参数。
0
ParseMaxRowCount long

解析的SQL行数(最大值)。

1
MaxLogicalReadCounts long

逻辑读次数(最大值)。

说明 仅SQL Server实例支持返回该参数。
0
MySQLTotalExecutionTimes long

MySQL执行时长(总值),单位:秒。

1
SQLServerTotalExecutionCounts long

SQL Server执行次数(总值)。

1
ReturnTotalRowCounts long

返回的SQL行数(总值)。

1
MaxLockTime long

锁定时长(最大值),单位:秒。

0
DBName string

数据库名称。

RDS_MySQL
MinRowsAffectedCounts long

受影响的行数(最小值)。

说明 仅SQL Server实例支持返回该参数。
0
TotalLogicalReadCounts long

逻辑读次数(总值)。

1
TotalPhysicalReadCounts long

物理读次数(总值)。

1
ReportTime string

数据报表生成日期。

2011-05-30Z
MaxPhysicalReadCounts long

物理读次数(最大值)。

说明 仅SQL Server实例支持返回该参数。
0
SQLServerTotalCpuTime long

CPU查询时间(总值),单位:秒。

说明 仅SQL Server实例支持返回该参数。
0
TotalIOWriteCounts long

I/O写次数(总值)。

说明 仅SQL Server实例支持返回该参数。
0
MaxRowsAffectedCounts long

受影响的行数(最大值)。

说明 仅SQL Server实例支持返回该参数。
0
AvgIOWriteCounts long

I/O写次数(平均值)。

说明 仅SQL Server实例支持返回该参数。
0
MinPhysicalReadCounts long

物理读次数(最小值)。

说明 仅SQL Server实例支持返回该参数。
0
SlowLogId long

慢查询汇总标识ID。

26584213
MaxExecutionTime long

执行时长(最大值),单位:秒。

60
AvgExecutionTime long

执行时间(平均值),单位:秒。

说明 仅SQL Server实例支持返回该参数。
1
SQLServerAvgExecutionTime long

执行时间(平均值),单位:秒。

说明 仅SQL Server实例支持返回该参数。
0
MaxIOWriteCounts long

I/O写次数(最大值)。

说明 仅SQL Server实例支持返回该参数。
0
SQLServerAvgCpuTime long

CPU查询时间(平均值),单位:秒。

说明 仅SQL Server实例支持返回该参数。
0
TotalLastRowsAffectedCounts long

最后一次受影响的行数(总值)。

说明 仅SQL Server实例支持返回该参数。
0
AvgLogicalReadCounts long

逻辑读次数(平均值)。

说明 仅SQL Server实例支持返回该参数。
0
SQLServerMinExecutionTime long

执行时间(最小值),单位:秒。

说明 仅SQL Server实例支持返回该参数。
0
SQLIdStr string

对应的是慢日志统计模版SQL的ID,现已废弃,请使用 SQLHASH

521584
SQLServerTotalExecutionTimes long

SQL Server执行时长(总值),单位:毫秒。

1000
AvgRowsAffectedCounts long

受影响的行数(平均值)。

说明 仅SQL Server实例支持返回该参数。
0
TotalRowsAffectedCounts long

影响的行数(总值)。

0
AvgPhysicalReadCounts long

物理读次数(平均值)。

说明 仅SQL Server实例支持返回该参数。
0
MinLogicalReadCounts long

逻辑读次数(最小值)。

说明 仅SQL Server实例支持返回该参数。
0

示例

正常返回示例

JSON 格式

{
  "EndTime": "2011-05-30Z",
  "StartTime": "2011-05-30Z",
  "RequestId": "2553A660-E4EB-4AF4-A402-8AFF70A49143",
  "PageRecordCount": 10,
  "TotalRecordCount": 5,
  "DBInstanceId": "rm-uf6wjk5xxxxxxx",
  "PageNumber": 1,
  "Engine": "MySQL",
  "Items": {
    "SQLSlowLog": [
        "MaxLastRowsAffectedCounts": 0,
        "ReturnMaxRowCount": 1,
        "SQLText": "select id,name from tb_table",
        "SQLServerMaxCpuTime": 0,
        "CreateTime": "2011-05-30Z",
        "AvgLastRowsAffectedCounts": 0,
        "MinLastRowsAffectedCounts": 0,
        "ParseTotalRowCounts": 1,
        "TotalLockTimes": 0,
        "MySQLTotalExecutionCounts": 1,
        "SQLServerMinCpuTime": 0,
        "SQLHASH": "U2FsdGVkxxxx",
        "MinIOWriteCounts": 0,
        "ParseMaxRowCount": 1,
        "MaxLogicalReadCounts": 0,
        "MySQLTotalExecutionTimes": 1,
        "SQLServerTotalExecutionCounts": 1,
        "ReturnTotalRowCounts": 1,
        "MaxLockTime": 0,
        "DBName": "RDS_MySQL",
        "MinRowsAffectedCounts": 0,
        "TotalLogicalReadCounts": 1,
        "TotalPhysicalReadCounts": 1,
        "ReportTime": "2011-05-30Z",
        "MaxPhysicalReadCounts": 0,
        "SQLServerTotalCpuTime": 0,
        "TotalIOWriteCounts": 0,
        "MaxRowsAffectedCounts": 0,
        "AvgIOWriteCounts": 0,
        "MinPhysicalReadCounts": 0,
        "SlowLogId": 26584213,
        "MaxExecutionTime": 60,
        "AvgExecutionTime": 1,
        "SQLServerAvgExecutionTime": 0,
        "MaxIOWriteCounts": 0,
        "SQLServerAvgCpuTime": 0,
        "TotalLastRowsAffectedCounts": 0,
        "AvgLogicalReadCounts": 0,
        "SQLServerMinExecutionTime": 0,
        "SQLIdStr": "521584",
        "SQLServerTotalExecutionTimes": 1000,
        "AvgRowsAffectedCounts": 0,
        "TotalRowsAffectedCounts": 0,
        "AvgPhysicalReadCounts": 0,
        "MinLogicalReadCounts": 0
}

错误码

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

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