本文导读

展开导读

文档首页/ 数据管理服务 DAS/ API参考/ API（公测中）/ 云DBA/ 导出SQL执行耗时区间数据

导出SQL执行耗时区间数据

更新时间：2024-11-13 GMT+08:00

查看PDF

功能介绍

TopSQL开关打开后，导出SQL执行耗时区间数据。该功能仅支持付费实例。查询时间间隔最长六小时。

URI

GET /v3/{project_id}/instances/{instance_id}/top-sql-trend

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参见获取项目ID。
instance_id	是	String	实例ID。

表2 Query参数
参数	是否必选	参数类型	描述
start_at	是	Long	开始时间（Unix timestamp），单位：毫秒。
end_at	是	Long	结束时间（Unix timestamp），单位：毫秒。
datastore_type	是	String	数据库类型。支持MySQL和TaurusDB。
node_id	否	String	节点ID。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。
X-Language	否	String	请求语言类型。枚举值： en-us zh-cn

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
interval_millis	Long	返回列表两个时间点之间的时间间隔。总查询时长一小时之内间隔10s，一小时到六小时范围内间隔60s，六小时以上间隔300s。单位为毫秒。
top_sql_trend_items	Array of TopSqlTrendItem objects	SQL执行耗时区间数据。
total_count	Integer	耗时区间数据总数。

表5 TopSqlTrendItem
参数	参数类型	描述
execute_at	Long	执行时间点，毫秒时间戳。表示统计数据的时间范围为execute_at - interval_millis到execute_at。
query_time_in_100ms	Long	执行耗时小于100ms。
query_time_in_500ms	Long	执行耗时100ms-500ms。
query_time_in_1s	Long	执行耗时500ms-1000ms
query_time_over_1s	Long	执行耗时大于1000ms。

状态码： 400

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码。最小长度：8 最大长度：36
error_msg	String	错误描述。最小长度：2 最大长度：512

状态码： 500

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码。最小长度：8 最大长度：36
error_msg	String	错误描述。最小长度：2 最大长度：512

请求示例

导出SQL执行耗时区间数据。

GET https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein01/top-sql-trend?start_at=1611975464337&end_at=1611979064337&datastore_type=MySQL&node_id=fec05693c76c4f389561051db430324cno01

响应示例

状态码： 200

Success.

{
  "top_sql_trend_items" : [ {
    "execute_at" : 1666702330000,
    "query_time_over_1s" : 1,
    "query_time_in_100ms" : 3,
    "query_time_in_1s" : 0,
    "query_time_in_500ms" : 0
  }, {
    "execute_at" : 1666702340000,
    "query_time_over_1s" : 2,
    "query_time_in_100ms" : 2,
    "query_time_in_1s" : 0,
    "query_time_in_500ms" : 0
  } ],
  "interval_millis" : 10000,
  "total_count" : 2
}

状态码

状态码	描述
200	Success.
400	Client error.
500	Server error.

错误码

请参见错误码。

父主题： 云DBA

上一篇：导出TopSQL模板列表

下一篇：导出慢SQL模板列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消