调用GetFullRequestOriginStatByInstanceId接口按访问来源统计全量请求数据-数据库自治服务-阿里云-数据库自治服务(DAS)-阿里云帮助中心

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

接口说明

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

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

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

hdm:GetFullRequestOriginStatByInstanceId

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
UserId	string	否	用户 ID，即创建数据库实例的阿里云主账号 ID。说明非必填，输入目标数据库实例 ID 后，在调用 API 接口时，系统会自动获取用户 ID。	196278346919****
InstanceId	string	是	实例 ID。	rm-2ze8g2am97624****
NodeId	string	否	节点 ID。说明对于 PolarDB MySQL 版实例，需要提供节点 ID。	pi-bp12v7243x012****
Start	integer	是	查询开始时间，格式为 Unix 时间戳，单位为毫秒。说明查询开始时间需在数据库实例 SQL 洞察存储时长范围内，最大不能早于当前时间 90 天。	1644716649000
End	integer	是	查询结束时间，格式为 Unix 时间戳，单位为毫秒。说明查询结束时间需晚于查询开始时间，且查询开始时间和查询结束时间的间隔不能超过 1 天。	1644803409000
OrderBy	string	否	排序字段，默认为 count。 count：执行次数。 avgRt：平均执行时间。 rtRate：耗时比例。 rowsExamined：总扫描行数。 avgRowsExamined：平均扫描行数。 avgRowsReturned：平均返回行数。	count
Asc	boolean	否	升序排序开关，默认关闭。	关闭
PageNo	integer	是	分页查询的页码，从 1 开始，默认为 1。	1
PageSize	integer	是	分页查询每页最大记录数，默认为 20。	20
SqlType	string	否	SQL 语句的类型，取值包括：SELECT、INSERT、UPDATE、DELETE、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 语句类型进行统计。	SELECT
Role	string	否	PolarDB-X 2.0 数据库实例节点（角色）信息。 polarx_cn：计算节点。 polarx_en：数据节点。	polarx_cn

返回参数

名称	类型	描述	示例值
	object	返回信息的详细列表。
Message	string	请求返回消息。说明请求成功时该参数返回 Successful，请求失败时会返回请求异常信息（如错误码等）	Successful
RequestId	string	请求 ID。	7172BECE-588A-5961-8126-C216E16B****
Data	object	返回数据。
List	array<object>	全量请求数据列表。
	object	全量请求数据列表。
Key	string	执行 SQL 的客户端 IP 地址。	172.26.6****
AvgFetchRows	integer	PolarDB-X 2.0 数据库实例计算节点平均拉取数据节点的行数。	0
AvgLockWaitTime	number	平均锁等待时长，单位为秒。	0.00009589874265269765
AvgLogicalRead	number	平均逻辑读。	654.4470327860251
AvgPhysicalAsyncRead	integer	平均物理异步读取。	0
AvgPhysicalSyncRead	number	平均物理同步读取。	0
AvgRows	integer	平均行数。	0
AvgExaminedRows	number	平均扫描行数。说明目前支持该字段的数据库：RDS MySQL、RDS PostgreSQL、PolarDB MySQL 版。	10000
AvgReturnedRows	number	平均返回行数。	10000
AvgUpdatedRows	number	平均修改行数。说明目前支持该字段的数据库：RDS MySQL、PolarDB-X 2.0。	10000
AvgRt	number	平均执行耗时。	2.499
AvgSqlCount	integer	平均 SQL 数量。	10000
Count	integer	总执行次数。	100000
CountRate	number	执行次数比例。	0.0586
Database	string	数据库名。	dbtest01
ErrorCount	integer	执行错误次数。	1
FetchRows	integer	PolarDB-X 2.0 数据库实例计算节点拉取数据节点的行数。	200
Ip	string	实例的网络地址。	rm-uf6dyi58dm6**.mysql.rds.aliy**.com
LockWaitTime	number	锁等待时长，单位为秒。	1089.4177720290281
LogicalRead	integer	逻辑读。	7.434573266E9
OriginHost	string	执行 SQL 的客户端 IP 地址。	172.26.6****
PhysicalAsyncRead	integer	物理异步读取。	0
PhysicalSyncRead	integer	物理同步读取。	0
Port	integer	端口号。	3306
Rows	integer	PolarDB-X 2.0 数据库实例计算节点总更新或返回的行数。	0
ExaminedRows	integer	总扫描行数。说明目前支持该字段的数据库：RDS MySQL、RDS PostgreSQL、PolarDB MySQL 版。	10000
RtGreaterThanOneSecondCount	integer	执行时长大于 1 秒的 SQL 数量。	2
RtRate	number	耗时比例。	0.1384
SqlCount	integer	SQL 的数量。	200
SumUpdatedRows	integer	总变更行数。	200
Version	integer	版本。	1
VpcId	string	VPC ID。	vpc-2zentqj1sk4qmolci****
Total	integer	总数据量。	1
Code	integer	返回的状态码。	200
Success	boolean	请求是否执行成功： true：执行成功。 false：执行失败。	true

示例

正常返回示例

JSON格式

{
  "Message": "Successful",
  "RequestId": "7172BECE-588A-5961-8126-C216E16B****",
  "Data": {
    "List": [
      {
        "Key": "172.26.6****",
        "AvgFetchRows": 0,
        "AvgLockWaitTime": 0.00009589874265269765,
        "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,
        "LogicalRead": 7434573266,
        "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
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParams	The request parameters are invalid.	请求参数错误
403	NoPermission	You are not authorized to do this action.	没有权限执行该操作

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

变更历史

更多信息，参考变更详情。