调用GetFullRequestOriginStatByInstanceId接口,按照访问来源统计数据库实例SQL洞察结果中的全量请求数据。

SQL洞察功能可对SQL进行健康情况诊断、性能问题排查,详情请参见SQL洞察

  • 目前支持的数据库实例请参见DAS专业版使用说明
  • 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。

请求参数

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

系统规定参数。取值:GetFullRequestOriginStatByInstanceId

UserId String 196278346919****

用户ID,即创建数据库实例的阿里云主账号ID。

说明 非必填,输入目标数据库实例ID后,在调用API接口时,系统会自动获取用户ID。
InstanceId String rm-2ze8g2am97624****

实例ID。

NodeId String pi-bp12v7243x012****

节点ID。

说明 对于PolarDB MySQL实例,需要提供节点ID。
Start Long 1644716649000

查询开始时间,格式为Unix时间戳,单位为毫秒。

说明 查询开始时间需在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。
End Long 1644803409000

查询结束时间,格式为Unix时间戳,单位为毫秒。

说明 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过1天。
OrderBy String count

排序字段,默认为count

  • count:执行次数。
  • avgRt:平均执行时间。
  • rtRate:耗时比例。
  • rowsExamined:总扫描行数。
  • avgRowsExamined:平均扫描行数。
  • avgRowsReturned:平均返回行数。
Asc Boolean 关闭

升序排序开关,默认关闭。

PageNo Integer 1

分页查询的页码,从1开始,默认为1。

PageSize Integer 20

分页查询每页最大记录数,默认为20。

SqlType String SELECT

SQL语句的类型,取值包括:SELECTINSERTUPDATEDELETELOGINLOGOUTMERGEALTERCREATEINDEXDROPINDEXCREATEDROPSETDESCREPLACECALLBEGINDESCRIBEROLLBACKFLUSHUSESHOWSTARTCOMMITRENAME

说明 当数据库实例为RDS MySQL、PolarDB MySQL、PolarDB-X 2.0时,可以通过SQL语句类型进行统计。
Role String polarx_cn

PolarDB-X 2.0数据库实例节点(角色)信息。

  • polarx_cn:计算节点。
  • polarx_en:数据节点。

返回数据

名称 类型 示例值 描述
Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)
RequestId String 7172BECE-588A-5961-8126-C216E16B****

请求ID。

Data Object

返回数据。

List Array of List

全量请求数据列表。

Key String 172.26.6****

执行SQL的客户端IP地址。

AvgFetchRows Long 0

PolarDB-X 2.0数据库实例计算节点平均拉取数据节点的行数。

AvgLockWaitTime double 0.00009589874265269765

平均锁等待时长,单位为秒。

AvgLogicalRead double 654.4470327860251

平均逻辑读。

AvgPhysicalAsyncRead Long 0

平均物理异步读取。

AvgPhysicalSyncRead double 0

平均物理同步读取。

AvgRows Long 0

平均行数。

AvgExaminedRows double 10000

平均扫描行数。

说明 目前支持该字段的数据库:RDS MySQL、RDS PostgreSQL、PolarDB MySQL。
AvgReturnedRows double 10000

平均返回行数。

AvgUpdatedRows double 10000

平均修改行数。

说明 目前支持该字段的数据库:RDS MySQL、PolarDB-X 2.0。
AvgRt double 2.499

平均执行耗时。

AvgSqlCount Long 10000

平均SQL数量。

Count Long 100000

总执行次数。

CountRate double 0.0586

执行次数比例。

Database String dbtest01

数据库名。

ErrorCount Long 1

执行错误次数。

FetchRows Long 200

PolarDB-X 2.0数据库实例计算节点拉取数据节点的行数。

Ip String rm-uf6dyi58dm6****.mysql.rds.aliy****.com

实例的网络地址。

LockWaitTime double 1089.4177720290281

锁等待时长,单位为秒。

LogicalRead Long 7.434573266E9

逻辑读。

OriginHost String 172.26.6****

执行SQL的客户端IP地址。

PhysicalAsyncRead Long 0

物理异步读取。

PhysicalSyncRead Long 0

物理同步读取。

Port Long 3306

端口号。

Rows Long 0

PolarDB-X 2.0数据库实例计算节点总更新或返回的行数。

ExaminedRows Long 10000

总扫描行数。

说明 目前支持该字段的数据库:RDS MySQL、RDS PostgreSQL、PolarDB MySQL。
RtGreaterThanOneSecondCount Long 2

执行时长大于1秒的SQL数量。

RtRate double 0.1384

耗时比例。

SqlCount Long 200

SQL的数量。

SumUpdatedRows Long 200

总变更行数。

Version Long 1

版本。

VpcId String vpc-2zentqj1sk4qmolci****

VPC ID。

Total Long 1

总数据量。

Code Long 200

返回的状态码。

Success Boolean true

请求是否执行成功:

  • true:执行成功。
  • false:执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetFullRequestOriginStatByInstanceId
&UserId=196278346919****
&InstanceId=rm-2ze8g2am97624****
&Start=1644716649000
&End=1644803409000
&OrderBy=count
&PageNo=1
&PageSize=20
&SqlType=SELECT
&公共请求参数

正常返回示例

XML格式

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

<GetFullRequestOriginStatByInstanceIdResponse>
    <Message>Successful</Message>
    <RequestId>7172BECE-588A-5961-8126-C216E16B****</RequestId>
    <Data>
        <List>
            <Key>172.26.6****</Key>
            <AvgFetchRows>0</AvgFetchRows>
            <AvgLockWaitTime>0.00009589874265269765</AvgLockWaitTime>
            <AvgLogicalRead>654.4470327860251</AvgLogicalRead>
            <AvgPhysicalAsyncRead>0</AvgPhysicalAsyncRead>
            <AvgPhysicalSyncRead>0</AvgPhysicalSyncRead>
            <AvgRows>0</AvgRows>
            <AvgExaminedRows>10000</AvgExaminedRows>
            <AvgReturnedRows>10000</AvgReturnedRows>
            <AvgUpdatedRows>10000</AvgUpdatedRows>
            <AvgRt>2.499</AvgRt>
            <AvgSqlCount>10000</AvgSqlCount>
            <Count>100000</Count>
            <CountRate>0.0586</CountRate>
            <Database>dbtest01</Database>
            <ErrorCount>1</ErrorCount>
            <FetchRows>200</FetchRows>
            <Ip>rm-uf6dyi58dm6****.mysql.rds.aliy****.com</Ip>
            <LockWaitTime>1089.4177720290281</LockWaitTime>
            <OriginHost>172.26.6****</OriginHost>
            <PhysicalAsyncRead>0</PhysicalAsyncRead>
            <PhysicalSyncRead>0</PhysicalSyncRead>
            <Port>3306</Port>
            <Rows>0</Rows>
            <ExaminedRows>10000</ExaminedRows>
            <RtGreaterThanOneSecondCount>2</RtGreaterThanOneSecondCount>
            <RtRate>0.1384</RtRate>
            <SqlCount>200</SqlCount>
            <SumUpdatedRows>200</SumUpdatedRows>
            <Version>1</Version>
            <VpcId>vpc-2zentqj1sk4qmolci****</VpcId>
        </List>
        <Total>1</Total>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</GetFullRequestOriginStatByInstanceIdResponse>

JSON格式

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

{
  "Message" : "Successful",
  "RequestId" : "7172BECE-588A-5961-8126-C216E16B****",
  "Data" : {
    "List" : [ {
      "Key" : "172.26.6****",
      "AvgFetchRows" : 0,
      "AvgLockWaitTime" : 9.589874265269765E-5,
      "AvgLogicalRead" : 654.4470327860251,
      "AvgPhysicalAsyncRead" : 0,
      "AvgPhysicalSyncRead" : 0,
      "AvgRows" : 0,
      "AvgExaminedRows" : 10000,
      "AvgReturnedRows" : 10000,
      "AvgUpdatedRows" : 10000,
      "AvgRt" : 2.499,
      "AvgSqlCount" : 10000,
      "Count" : 100000,
      "CountRate" : 0.0586,
      "Database" : "dbtest01",
      "ErrorCount" : 1,
      "FetchRows" : 200,
      "Ip" : "rm-uf6dyi58dm6****.mysql.rds.aliy****.com",
      "LockWaitTime" : 1089.4177720290281,
      "OriginHost" : "172.26.6****",
      "PhysicalAsyncRead" : 0,
      "PhysicalSyncRead" : 0,
      "Port" : 3306,
      "Rows" : 0,
      "ExaminedRows" : 10000,
      "RtGreaterThanOneSecondCount" : 2,
      "RtRate" : 0.1384,
      "SqlCount" : 200,
      "SumUpdatedRows" : 200,
      "Version" : 1,
      "VpcId" : "vpc-2zentqj1sk4qmolci****"
    } ],
    "Total" : 1
  },
  "Code" : 200,
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The request parameters are invalid. 请求参数错误

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