根据用户定义的查询条件,获取SQL执行的性能统计信息,例如慢SQL等。用户可以根据这些信息查找与SQL执行相关的性能瓶颈,并进行优化。
- 仅支持SQL Server
GET
名称 | 类型 | 是否必需 | 默认值 | 描述 |
---|---|---|---|---|
regionId | String | True | 地域代码,取值范围参见《各地域及可用区对照表》 | |
instanceId | String | True | RDS 实例ID,唯一标识一个RDS实例 |
名称 | 类型 | 是否必需 | 默认值 | 描述 |
---|---|---|---|---|
queryType | String | True | 查询类型,不同的查询类型按照相应的字段从高到低返回结果。 支持如下类型: ExecutionCount:执行次数 LastRows:上次返回行数 ElapsedTime:平均执行时间 CPUTime:平均CPU时间 LogicalReads:平均逻辑读 LogicalWrites:平均逻辑写 PhysicalReads:平均物理读 |
|
threshold | Integer | False | 只返回查询条件大于等于threshold的记录,默认为0 | |
pageNumber | Integer | False | 显示数据的页码,默认为1,取值范围:[-1,1000]。pageNumber为-1时,返回所有数据页码;超过总页数时,显示最后一页。 | |
pageSize | Integer | False | 每页显示的数据条数,默认为50,取值范围:[1,100],只能为10的倍数,用于查询列表的接口 |
名称 | 类型 | 描述 |
---|---|---|
result | Result |
名称 | 类型 | 描述 |
---|---|---|
queryPerformanceResult | QueryPerformanceResult[ ] | 查询性能统计结果集 |
totalCount | Integer | 总记录条数 |
pageNumber | Integer | 当前数据的页码 |
pageSize | Integer | 每页显示的数据条数 |
名称 | 类型 | 描述 |
---|---|---|
sql | String | sql语句 |
lastExecutionTime | String | 上次执行时间,格式为YYYY-MM-DD hh:mm:ss |
elapsedTime | Integer | 平均执行时长,单位毫秒(ms) |
executionCount | Integer | 执行次数 |
workerTime | Integer | 平均CPU使用时间,单位毫秒(ms) |
logicalReads | Integer | 平均逻辑读次数 |
logicalWrites | Integer | 平均逻辑写次数 |
physicalReads | Integer | 平均物理读次数 |
lastRows | Integer | 上次返回记录数 |
返回码 | 描述 |
---|---|
200 | OK |
GET
public void testDescribeQueryPerformance() { DescribeQueryPerformanceRequest request = new DescribeQueryPerformanceRequest(); request.setRegionId("cn-north-1"); request.setInstanceId("sqlserver-83uqv7avy4"); request.setQueryType("LogicalReads"); request.setPageSize(10); request.setPageNumber(1); DescribeQueryPerformanceResponse response = rdsClient.describeQueryPerformance(request); System.out.println(new Gson().toJson(response)); }
{ "requestId": "bpaohu1t9up4ide0a9g4pwcoinp86hwn", "result": { "pageNumber": 1, "pageSize": 10, "queryPerformanceResult": [ { "elapsedTime": 1, "executionCount": 7, "lastExecutionTime": "2020-01-08 14:35:51.440", "lastRows": 3, "logicalReads": 43, "logicalWrites": 0, "physicalReads": 0, "sql": "select 1", "workerTime": 1 } ], "totalCount": 1 } }