更新时间:2025-08-28 GMT+08:00
分享

导出慢SQL统计数据

功能介绍

慢SQL开关打开后,导出慢SQL统计数据。

调试

您可以在API Explorer中调试该接口。

URI

POST /v3/{project_id}/instances/{instance_id}/slow-sql-statistics

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

租户在某一Region下的项目ID。

获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值:

不涉及。

instance_id

String

参数解释:

实例ID。标识实例的唯一标识。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

datastore_type

String

参数解释:

数据库类型。

约束限制:

不涉及。

取值范围:

  • DDS-Community

默认取值:

不涉及。

start_at

Long

参数解释:

开始时间。

约束限制:

Unix timestamp,单位:毫秒。

取值范围:

[0, 2^31-1],实际取决于查询。

默认取值:

不涉及。

end_at

Long

参数解释:

结束时间。

约束限制:

Unix timestamp,单位:毫秒。

取值范围:

[0, 2^31-1],实际取决于查询。

默认取值:

不涉及。

node_ids

Array of strings

参数解释:

节点ID列表。

约束限制:

可组合,用逗号分隔。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值:

不涉及。

statistics_field

String

参数解释:

统计字段。

约束限制:

不涉及。

取值范围:

  • node_id
  • sql_type
  • db_name
  • collection
  • user
  • client

默认取值:

node_id

offset

Integer

参数解释:

索引位置,偏移量。从第一条数据偏移offset条数据后开始查询。例如:该参数指定为1,limit指定为10,则只展示第2~11条数据。

约束限制:

不涉及。

取值范围:

[0, 2^31-1]

默认取值:

默认为0(偏移0条数据,表示从第一条数据开始查询)。

limit

Integer

参数解释:

每页记录数。

约束限制:

不涉及。

取值范围:

[1, 100]

默认取值:

默认为20。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

statistics_list

Array of 表4 SlowSqlStatistics objects

参数解释:

慢SQL统计列表。

取值范围:

不涉及。

total_count

Integer

参数解释:

总数。

取值范围:

[0, 2^31-1]

表4 SlowSqlStatistics

参数

参数类型

描述

execute_count

Long

参数解释:

执行次数。

取值范围:

不涉及。

avg_execute_time

Double

参数解释:

平均执行耗时(s)。

取值范围:

不涉及。

max_execute_time

Double

参数解释:

最大执行耗时(s)。

取值范围:

不涉及。

avg_lock_wait_time

Double

参数解释:

平均锁等待时间(s)。

取值范围:

不涉及。

max_lock_wait_time

Double

参数解释:

最大锁等待时间(s)。

取值范围:

不涉及。

avg_rows_sent

Double

参数解释:

平均返回文档数。

取值范围:

不涉及。

max_rows_sent

Double

参数解释:

最大返回文档数。

取值范围:

不涉及。

avg_rows_examined

Double

参数解释:

平均扫描文档数。

取值范围:

不涉及。

max_rows_examined

Double

参数解释:

最大扫描文档数。

取值范围:

不涉及。

avg_key_examined

Double

参数解释:

平均扫描索引数。

取值范围:

不涉及。

max_key_examined

Double

参数解释:

最大扫描索引数。

取值范围:

不涉及。

node_id

String

参数解释:

节点ID,按node_id统计时赋值。

取值范围:

不涉及。

node_name

String

参数解释:

节点名称,按node_id统计时赋值。

取值范围:

不涉及。

sql_type

String

参数解释:

语句类型,按sql_type统计时赋值。

取值范围:

不涉及。

db_name

String

参数解释:

库名,按db_name、collection统计时赋值。

取值范围:

不涉及。

collection

String

参数解释:

数据库表,按collection统计时赋值。

取值范围:

不涉及。

user

String

参数解释:

用户名,按user统计时赋值。

取值范围:

不涉及。

client

String

参数解释:

客户端,按client统计时赋值。

取值范围:

不涉及。

请求示例

导出慢SQL数据。

"POST https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein02/slow-sql-statistics"

响应示例

状态码: 200

Success.

{  "statistics_list": [
{
"execute_count": 6,
"avg_execute_time": 5.000509315066868,
"max_execute_time": 5.008123874664307,
"avg_lock_wait_time": 1,
"max_lock_wait_time": 1,
"avg_rows_sent": 1,
"max_rows_sent": 1,
"avg_rows_examined": 0,
"max_rows_examined": 0,
"avg_key_examined": 0,
"max_key_examined": 0,
"node_id": "fec05693c76c4f389561051db430324cno02",
"node_name": "dds-1234_node_1"
}
],
"total_count": 1
}

状态码

状态码

描述

200

成功。

400

客户端错误。

500

服务器错误。

错误码

请参见错误码

相关文档