导出全量SQL明细
功能介绍
全量SQL开关打开后,创建SQL洞察任务,支持按节点、用户名、数据库、操作类型等导出全量SQL明细数据。该功能仅支持付费实例。
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/instances/{instance_id}/full-sql-search
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
instance_id |
是 |
String |
参数解释: 实例ID。标识实例的唯一标识。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
start_at |
是 |
Long |
参数解释: 开始时间(Unix timestamp),单位:毫秒。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
end_at |
是 |
Long |
参数解释: 结束时间(Unix timestamp),单位:毫秒。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
task_ids |
否 |
Array of long |
参数解释: SQL洞察任务ID列表,时间范围大于1天的SQL洞察任务后台将拆分为多个任务解析,该场景支持多任务过滤导出。 约束限制: 可组合,用逗号分隔。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
node_id |
否 |
String |
参数解释: 节点ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
keyword |
否 |
String |
参数解释: 关键字。 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
fuzzy |
否 |
String |
参数解释: 是否模糊匹配。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
user_list |
否 |
String |
参数解释: 用户名 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
db_list |
否 |
String |
参数解释: 数据库 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
operation_list |
否 |
String |
参数解释: 操作类型 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
client_ip_list |
否 |
String |
参数解释: 客户端IP 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
thread_id_list |
否 |
String |
参数解释: 线程ID 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
trx_id_list |
否 |
String |
参数解释: 事务ID 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
session_id_list |
否 |
String |
参数解释: 会话ID 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
status_list |
否 |
String |
参数解释: 执行状态 约束限制: 可组合,用逗号分隔。 取值范围:
默认取值: 不涉及。 |
sql_template_ids |
否 |
String |
参数解释: SQL模板ID 约束限制: 可组合,用逗号分隔。 取值范围: 不涉及。 默认取值: 不涉及。 |
cost_min |
否 |
Double |
参数解释: 最小执行耗时(毫秒)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
cost_max |
否 |
Double |
参数解释: 最大执行耗时(毫秒)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
scan_min |
否 |
Long |
参数解释: 最小扫描行数。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
scan_max |
否 |
Long |
参数解释: 最大扫描行数。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
affect_min |
否 |
Long |
参数解释: 最小影响行数。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
affect_max |
否 |
Long |
参数解释: 最大影响行数。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
return_min |
否 |
Long |
参数解释: 最小返回行数。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
return_max |
否 |
Long |
参数解释: 最大返回行数。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
sort_field |
否 |
String |
参数解释: 排序字段。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
asc |
否 |
Boolean |
参数解释: 排序顺序。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
page |
否 |
Integer |
参数解释: 页码。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
limit |
否 |
Integer |
参数解释: 每页记录数。 约束限制: 不涉及。 取值范围: [0, 100],实际取决于查询。 默认取值: 不涉及。 |
请求参数
无。
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
full_sql_details |
Array of 表4 objects |
参数解释: 全量SQL明细列表。 取值范围: 不涉及。 |
total |
Integer |
参数解释: 总数。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
sql |
String |
参数解释: SQL语句。 取值范围: 不涉及。 |
sql_template_id |
String |
参数解释: SQL模板ID。 取值范围: 不涉及。 |
operate_type |
String |
参数解释: 操作类型。 取值范围: 不涉及。 |
status |
String |
参数解释: 状态。 取值范围: 不涉及。 |
error_no |
String |
参数解释: 错误码。 取值范围: 不涉及。 |
database |
String |
参数解释: 数据库。 取值范围: 不涉及。 |
thread_id |
String |
参数解释: 线程ID。 取值范围: 不涉及。 |
client |
String |
参数解释: 客户端。 取值范围: 不涉及。 |
user |
String |
参数解释: 用户。 取值范围: 不涉及。 |
execute_at |
Long |
参数解释: 执行开始时间(Unix timestamp),单位:毫秒。 取值范围: 不涉及。 |
query_time |
Double |
参数解释: 执行耗时(毫秒)。 取值范围: 不涉及。 |
lock_time |
Double |
参数解释: 锁等待耗时(毫秒)。 取值范围: 不涉及。 |
rows_examined |
Long |
参数解释: 扫描行数。 取值范围: 不涉及。 |
rows_sent |
Long |
参数解释: 返回行数。 取值范围: 不涉及。 |
rows_affected |
Long |
参数解释: 更新行数。 取值范围: 不涉及。 |
trx_id |
Long |
参数解释: 事务ID。 取值范围: 不涉及。 |
cpu_time |
Double |
参数解释: CPU耗时(微秒)。 取值范围: 不涉及。 |
send_bytes |
Long |
参数解释: 网络发送字节数。 取值范围: 不涉及。 |
query_tables |
String |
参数解释: 查询中所有的表名(格式:库名.表名|库名.表名)。 取值范围: 不涉及。 |
innodb_io_read_bytes |
Long |
参数解释: 物理I/O读字节数。 取值范围: 不涉及。 |
innodb_io_read |
Integer |
参数解释: 物理I/O读次数。 取值范围: 不涉及。 |
innodb_io_read_wait |
Double |
参数解释: 物理I/O读取等待耗时(毫秒)。 取值范围: 不涉及。 |
innodb_lock_wait |
Double |
参数解释: 行锁等待耗时(毫秒)。 取值范围: 不涉及。 |
innodb_queue_wait |
Double |
参数解释: 进入innodb的等待耗时(毫秒)。 取值范围: 不涉及。 |
kernel_version |
String |
参数解释: 内核版本号,DDM实例使用。 取值范围: 不涉及。 |
query_time_detail |
String |
参数解释: SQL执行各阶段细分耗时,DDM实例使用。 取值范围: 不涉及。 |
session_id |
String |
参数解释: 会话ID。 取值范围: 不涉及。 |
node_id |
String |
参数解释: 节点ID。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 |
请求示例
GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/full-sql-search?start_at=1738733117000&end_at=1738808281000&task_ids=1128
响应示例
状态码: 200
{ "full_sql_details": [ { "sql": "select sleep(90)", "sql_template_id": "AAD913807ECE9C66", "operate_type": "select", "status": "success", "error_no": "", "database": "test_db", "thread_id": "5866666", "client": "100.79.3.154", "user": "root", "execute_at": 1738808280958, "query_time": 90000, "lock_time": 0, "rows_examined": 0, "rows_sent": 1, "rows_affected": 0, "trx_id": 0, "cpu_time": 0, "node_id": "fec05693c76c4f389561051db430324cno01" } ], "total": 1036 }
状态码
状态码 |
描述 |
---|---|
200 |
导出全量SQL明细。 |
400 |
客户端错误。 |
500 |
服务器错误。 |
错误码
请参见错误码。