- 最新动态
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 权限管理
- 登录数据库实例
- MySQL
- RDS for SQL Server
- PostgreSQL
- RDS for MariaDB
- GaussDB
- TaurusDB
- GeminiDB Cassandra
- GaussDB(DWS)（即将下线）
- DDS
- DDM
- 审计
- 事件监控
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
-
API（公测中）
- 获取API版本
-
云DBA
- 注册数据库用户
- 修改数据库用户
- 删除数据库用户
- 查询云DBA配额
- 查询数据库用户信息
- 查询数据库用户列表
- 查杀会话
- 查询SQL执行计划（GET请求）
- 查询SQL执行计划（POST请求）
- 查询元数据锁列表
- 查询实例会话列表
- 查询InnoDB锁等待列表
- 开启/关闭全量SQL、慢SQL开关
- 查询全量SQL和慢SQL的开关状态
- 导出慢SQL数据
- 导出全量SQL
- 查看SQL限流开关状态
- 设置SQL限流开关状态
- 查询SQL限流规则列表
- 根据原始SQL生成SQL限流关键字
- 创建SQL限流规则
- 删除SQL限流规则
- 查询SQL限流任务
- 导出TopSQL模板列表
- 导出SQL执行耗时区间数据
- 导出慢SQL模板列表
- 获取DAS云DBA实例列表
- 设置共享链接
- 删除共享链接
- 执行SQL诊断
- 获取诊断结果
- 创建实例健康诊断任务
- 查询实例健康诊断报告列表
- 获取实例健康诊断报告内容
- 同步实例列表
- API（不再推广）
- 权限策略和授权项
- 附录
- 常见问题
- 产品术语
-
更多文档
- 用户指南（阿布扎比区域）
- 用户指南（吉隆坡区域）
- 通用参考
链接复制成功！
导出TopSQL模板列表
功能介绍
TopSQL开关打开后，导出TopSQL模板列表。该功能仅支持付费实例。查询时间间隔最长一小时。
URI
GET /v3/{project_id}/instances/{instance_id}/top-sql-templates
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 获取方法请参见获取项目ID。 |
|
instance_id |
是 |
String |
实例ID。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
start_at |
是 |
Long |
开始时间（Unix timestamp），单位：毫秒。 |
|
end_at |
是 |
Long |
结束时间（Unix timestamp），单位：毫秒。 |
|
datastore_type |
是 |
String |
数据库类型。支持MySQL和TaurusDB。 |
|
node_id |
否 |
String |
节点ID。 |
|
sort |
否 |
String |
排序字段（executeNum:执行次数, totalCost:总耗时, avgCost:平均耗时, totalScan: 总扫描行数, avgScan:平均扫描行数）。 缺省值：avgCost 枚举值：
|
|
asc |
否 |
Boolean |
排序顺序（true:正序, false:逆序）。 缺省值：false |
|
offset |
否 |
Integer |
偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 |
|
limit |
否 |
Integer |
每页记录数，默认为20，最大取值100。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 |
|
X-Language |
否 |
String |
请求语言类型。 枚举值：
|
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
top_sql_templates |
Array of TopSqlTemplate objects |
SQL模板列表。 |
|
total_count |
Integer |
SQL模板总数。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
sql_template |
String |
SQL模板。 |
|
sql_sample_string |
String |
SQL样本。 |
|
sql_type |
String |
SQL操作类型。 |
|
db_name |
String |
数据库名称。 |
|
execute_num |
Long |
总执行次数。 |
|
total_cost |
Double |
总耗时(ms)。 |
|
avg_cost |
Double |
平均耗时(ms)。 |
|
avg_rows_sent |
Double |
平均返回行数。 |
|
avg_rows_affected |
Double |
平均影响行数。 |
|
avg_lock_time |
Double |
平均锁等待耗时(ms)。 |
|
total_rows_examined |
Double |
总扫描行数。 |
|
avg_rows_examined |
Double |
平均扫描行数。 |
|
total_cost_ratio |
String |
总耗时占比。 |
|
total_examined_ratio |
String |
扫描行数占比。 |
|
execute_num_ratio |
String |
执行次数占比。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 最小长度：8 最大长度：36 |
|
error_msg |
String |
错误描述。 最小长度：2 最大长度：512 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 最小长度：8 最大长度：36 |
|
error_msg |
String |
错误描述。 最小长度：2 最大长度：512 |
请求示例
导出TopSQL模板列表。
GET https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein01/top-sql-templates?start_at=1611975464337&end_at=1611979064337&node_id=fec05693c76c4f389561051db430324cno01&sort=avgCost&asc=true&datastore_type=MySQL&offset=0&limit=10
响应示例
状态码： 200
Success.
{
"top_sql_templates" : [ {
"db_name" : "db_01",
"execute_num" : 30,
"avg_rows_examined" : 0,
"total_cost_ratio" : "100.00%",
"avg_lock_time" : 0,
"sql_template" : "SELECT sleep(?)",
"avg_rows_affected" : 0,
"avg_rows_sent" : 1,
"avg_cost" : 5000.266666666666,
"execute_num_ratio" : "23.81%",
"total_examined_ratio" : "-",
"sql_type" : "select",
"total_cost" : 150008,
"total_rows_examined" : 0,
"sql_sample_string" : "select sleep(5)"
} ],
"total_count" : 1
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
Success. |
|
400 |
Client error. |
|
500 |
Server error. |
错误码
请参见错误码。
