慢日志统计非实时采集,可能会有6~8小时的延迟。

调试

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

调试
调试

授权信息

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

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

请求参数

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

实例ID。可调用 DescribeDBInstances 获取。

rm-uf6wjk5****
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-uf6wjk5****
    PageNumber integer

    页码。

    1
    Engine string

    数据库类型。

    MySQL
    Items 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语句的慢日志明细。

    U2FsdGVk****
    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
    MaxLockTimeMS long

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

    1000
    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
    MaxExecutionTimeMS long

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

    60000
    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-uf6wjk5****",
      "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": "U2FsdGVk****",
            "MinIOWriteCounts": 0,
            "ParseMaxRowCount": 1,
            "MaxLogicalReadCounts": 0,
            "MySQLTotalExecutionTimes": 1,
            "SQLServerTotalExecutionCounts": 1,
            "ReturnTotalRowCounts": 1,
            "MaxLockTime": 0,
            "MaxLockTimeMS": 1000,
            "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,
            "MaxExecutionTimeMS": 60000,
            "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 -

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

    变更历史

    变更时间 变更内容概要 操作
    2023-05-24 OpenAPI 错误码发生变更,OpenAPI 返回结构发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      删除错误码:400
    出参 OpenAPI 返回结构发生变更