调用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。
|
Asc | Boolean | 否 | 关闭 |
升序排序开关,默认关闭。 |
PageNo | Integer | 是 | 1 |
分页查询的页码,从1开始,默认为1。 |
PageSize | Integer | 是 | 20 |
分页查询每页最大记录数,默认为20。 |
SqlType | String | 否 | SELECT |
SQL语句的类型,取值包括:SELECT、INSERT、UPDATE、DELETE、LOGIN、LOGOUT、MERGE、ALTER、CREATEINDEX、DROPINDEX、CREATE、DROP、SET、DESC、REPLACE、CALL、BEGIN、DESCRIBE、ROLLBACK、FLUSH、USE、SHOW、START、COMMIT和RENAME。 说明 当数据库实例为RDS MySQL、PolarDB MySQL、PolarDB-X 2.0时,可以通过SQL语句类型进行统计。
|
Role | String | 否 | polarx_cn |
PolarDB-X 2.0数据库实例节点(角色)信息。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 |
请求是否执行成功:
|
示例
请求示例
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. | 请求参数错误 |
访问错误中心查看更多错误码。