文档首页/ 数据管理服务 DAS/ API参考/ API(公测中)/ 云DBA/ SQL多条件检索 - FullSqlSearch
更新时间:2025-11-28 GMT+08:00
分享

SQL多条件检索 - FullSqlSearch

功能介绍

SQL多条件检索。

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    das:clouddba:fullSqlList

    read

    instance

    -

    -

    -

URI

GET /v3/{project_id}/fullsql/search

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

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

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

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

参数解释:

执行状态

约束限制:

可组合,用逗号分隔。

取值范围:

  • 0:成功
  • 1:失败

默认取值:

不涉及。

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

参数解释:

排序字段。

约束限制:

不涉及。

取值范围:

  • execute_at:执行时间
  • execute_cost:执行耗时
  • lock_wait_time:锁等待时间
  • rows_examined:扫描行数
  • rows_returned:返回行数

默认取值:

不涉及。

asc

Boolean

参数解释:

排序顺序。

约束限制:

不涉及。

取值范围:

  • true:正序
  • false:逆序

默认取值:

不涉及。

page_no

Integer

参数解释:

页码。

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

page_size

Integer

参数解释:

每页记录数。

约束限制:

不涉及。

取值范围:

[0, 100],实际取决于查询。

默认取值:

不涉及。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

sql_item_dto_list

Array of 表4 objects

参数解释:

SQL列表。

取值范围:

不涉及。

total

Long

参数解释:

总数。

取值范围:

最大10万行。

表4 SQL列表

参数

参数类型

描述

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.

错误码

请参见错误码

相关文档