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. |
错误码
请参见错误码。

