文档首页/数据管理服务 DAS/API参考/API（公测中）/云DBA/导出慢SQL模板列表 - ExportTheSlowSQLTemplateList
更新时间：2025-11-21 GMT+08:00
查看PDF
分享

导出慢SQL模板列表 - ExportTheSlowSQLTemplateList

功能介绍

  • 慢SQL开关打开后，导出慢SQL模板列表。
  • 免费实例仅支持查看最近一小时数据。
  • 查询时间间隔最长一天。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    das:clouddba:slowSqlExport

    list

    instance

    -

    -

    -

URI

GET /v3/{project_id}/instances/{instance_id}/slow-sql-templates

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

instance_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

start_at

是

Long

参数解释：

开始时间（Unix timestamp），单位：毫秒。

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

end_at

是

Long

参数解释：

结束时间（Unix timestamp），单位：毫秒。

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

datastore_type

是

String

参数解释：

数据库类型。

约束限制：

不涉及

取值范围：

  • MySQL
  • TaurusDB

默认取值：

不涉及。

db_name

否

String

参数解释：

数据库名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

offset

否

Integer

参数解释：

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

约束限制：

不涉及。

取值范围：

[0, 2^31-1]

默认取值：

默认为0（偏移0条数据，表示从第一条数据开始查询）。

limit

否

Integer

参数解释：

查询记录数。例如该参数设定为10，则查询结果最多只显示10条记录。

约束限制：

不涉及。

取值范围：

[1, 100]

默认取值：

默认为20。

请求参数

无。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

slow_sql_templates

Array of SlowSqlTemplate objects

参数解释：

慢日志模板数据列表。

取值范围：

不涉及。

total_count

Integer

参数解释：

慢日志模板总数。

取值范围：

不涉及。

表4 SlowSqlTemplate

参数

参数类型

描述

sql_template

String

参数解释：

SQL模板。

取值范围：

不涉及。

sql_template_id

String

参数解释：

SQL模板ID。

取值范围：

不涉及。

sql_sample

String

参数解释：

SQL样本。

取值范围：

不涉及。

sql_sample_user

String

参数解释：

SQL样本执行用户。

取值范围：

不涉及。

db_names

Array of strings

参数解释：

库名。

取值范围：

不涉及。

execute_count

Long

参数解释：

执行次数。

取值范围：

不涉及。

avg_execute_time

Double

参数解释：

平均执行耗时(ms)。

取值范围：

不涉及。

max_execute_time

Double

参数解释：

最大执行耗时(ms)。

取值范围：

不涉及。

avg_lock_wait_time

Double

参数解释：

平均锁等待时间(ms)。

取值范围：

不涉及。

max_lock_wait_time

Double

参数解释：

最大锁等待时间(ms)。

取值范围：

不涉及。

avg_rows_examined

Double

参数解释：

平均扫描行数。

取值范围：

不涉及。

max_rows_examined

Double

参数解释：

最大扫描行数。

取值范围：

不涉及。

avg_rows_sent

Double

参数解释：

平均返回行数。

取值范围：

不涉及。

max_rows_sent

Double

参数解释：

最大返回行数。

取值范围：

不涉及。

请求示例

导出慢SQL模板列表。

GET https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein01/slow-sql-templates?startAt=1611975464337&endAt=1611979064337&datastore_type=MySQL&db_name=db&offset=0&limit=10

响应示例

状态码： 200

Success.

{ 
  "slow_sql_templates" : [ { 
    "max_rows_examined" : 0, 
    "max_lock_wait_time" : 0, 
    "avg_rows_examined" : 0, 
    "execute_count" : 27, 
    "avg_execute_time" : 5.000509315066868, 
    "max_execute_time" : 5.008123874664307, 
    "avg_lock_wait_time" : 0, 
    "sql_template" : "SELECT sleep(?);", 
    "sql_template_id": "1D7880577913B207",
    "sql_sample" : "select sleep(5)", 
    "avg_rows_sent" : 1, 
    "db_names" : [ "db_01" ], 
    "max_rows_sent" : 1 
  } ], 
  "total_count" : 1 
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

父主题：云DBA