SQL多条件检索 - FullSqlSearch
功能介绍
SQL多条件检索。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
das:clouddba:fullSqlList
read
instance
-
-
-
URI
GET /v3/{project_id}/fullsql/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_id |
否 |
long |
参数解释: SQL洞察任务ID,与task_ids参数二选一。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
|
task_ids |
否 |
Array of long |
参数解释: SQL洞察任务ID列表,时间范围大于1天的SQL洞察任务后台将拆分为多个任务解析,与task_id参数二选一。 约束限制: 可组合,用逗号分隔。 取值范围: [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_no |
否 |
Integer |
参数解释: 页码。 约束限制: 不涉及。 取值范围: [0, 2^31-1],实际取决于查询。 默认取值: 不涉及。 |
|
page_size |
否 |
Integer |
参数解释: 每页记录数。 约束限制: 不涉及。 取值范围: [0, 100],实际取决于查询。 默认取值: 不涉及。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
sql_item_dto_list |
Array of 表4 objects |
参数解释: SQL列表。 取值范围: 不涉及。 |
|
total |
Long |
参数解释: 总数。 取值范围: 最大10万行。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: SQL的ID值。 取值范围: 不涉及。 |
|
operate_type |
String |
参数解释: 操作类型。 取值范围: 不涉及。 |
|
sql_template_id |
String |
参数解释: 模板ID。 取值范围: 不涉及。 |
|
sql |
String |
参数解释: SQL文本。 取值范围: 不涉及。 |
|
database |
String |
参数解释: 数据库名称。 取值范围: 不涉及。 |
|
thread_id |
String |
参数解释: 线程ID。 取值范围: 不涉及。 |
|
username |
String |
参数解释: 用户名称。 取值范围: 不涉及。 |
|
client_ip |
String |
参数解释: 客户端IP。 取值范围: 不涉及。 |
|
status |
Integer |
参数解释: 执行状态。 取值范围: 不涉及。 |
|
execute_cost |
Double |
参数解释: 执行耗时(ms)。 取值范围: 不涉及。 |
|
execute_at |
Double |
参数解释: 执行时间点(ms)。 取值范围: 不涉及。 |
|
rows_affected |
Integer |
参数解释: 更新行数。 取值范围: 不涉及。 |
|
rows_examined |
Integer |
参数解释: 扫描行数。 取值范围: 不涉及。 |
|
lock_wait_time |
Double |
参数解释: 锁等待时间。 取值范围: 不涉及。 |
|
rows_returned |
Integer |
参数解释: 返回行数。 取值范围: 不涉及。 |
|
trx_id |
Long |
参数解释: 事务ID。 取值范围: 不涉及。 |
|
cpu_time |
String |
参数解释: 模板ID。 取值范围: 不涉及。 |
|
send_bytes |
Long |
参数解释: 网络发送字节数。 取值范围: 不涉及。 |
|
query_tables |
String |
参数解释: 查询中所有的表名(格式:库名.表名|库名.表名)。 取值范围: 不涉及。 |
|
innodb_io_read_bytes |
Long |
参数解释: 物理IO读字节数。 取值范围: 不涉及。 |
|
innodb_io_read |
Integer |
参数解释: 物理IO读次数。 取值范围: 不涉及。 |
|
innodb_io_read_wait |
Double |
参数解释: 物理IO读取等待耗时(ms)。 取值范围: 不涉及。 |
|
innodb_lock_wait |
Double |
参数解释: 行锁等待耗时(ms)。 取值范围: 不涉及。 |
|
innodb_queue_wait |
Double |
参数解释: 进入innodb的等待耗时(ms)。 取值范围: 不涉及。 |
|
kernel_version |
String |
参数解释: 内核版本号,ddm使用。 取值范围: 不涉及。 |
|
query_time_detail |
String |
参数解释: SQL执行各阶段细分耗时,ddm使用。 取值范围: 不涉及。 |
|
session_id |
String |
参数解释: 会话ID。 取值范围: 不涉及。 |
|
error_no |
Integer |
参数解释: 错误码。 取值范围: 不涉及。 |
|
node_id |
String |
参数解释: 节点ID。 取值范围: 不涉及。 |
|
logical_reads |
Long |
参数解释: sqlserver: IO逻辑读。 取值范围: 不涉及。 |
|
physical_reads |
Long |
参数解释: sqlserver: IO物理读。 取值范围: 不涉及。 |
|
writes |
Long |
参数解释: sqlserver: IO写。 取值范围: 不涉及。 |
|
app_name |
String |
参数解释: sqlserver: 应用名。 取值范围: 不涉及。 |
请求示例
POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/fullsql/search?instance_id=bcfa975193f1402fa11a6d4fd6baf5fbin01&page_no=1&page_size=20&sort_field=&asc=&start_at=1763531906000&end_at=1763618306000&fuzzy=false&task_id=1620
响应示例
状态码: 200
Success.
{
"total": 1,
"sql_item_dto_list": [
{
"operate_type": "select",
"sql_template_id": "199E7DCA63EA8858",
"instance_id": "bcfa975193f1402fa11a6d4fd6baf5fbin01",
"sql": "SELECT 1",
"database": "",
"thread_id": 27694776,
"username": "root",
"client_ip": "100.79.0.247",
"status": 0,
"execute_cost": 0,
"execute_at": 1763614186833,
"rows_affected": 0,
"rows_examined": 0,
"lock_wait_time": 0,
"rows_returned": 1,
"trx_id": 0,
"cpu_time": 0,
"session_id": "27694776",
"error_no": 0,
"node_id": "7c1efa30d2a340b68bc0a80652e14179no01"
}
]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
Success. |
|
400 |
Client error. |
|
500 |
Server error. |
错误码
请参见错误码。