本文导读

功能介绍
调试
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 数据管理服务 DAS/ API参考/ API（公测中）/ 云DBA/ 导出全量SQL明细

导出全量SQL明细

更新时间：2025-02-27 GMT+08:00

查看PDF

功能介绍

全量SQL开关打开后，创建SQL洞察任务,支持按节点、用户名、数据库、操作类型等导出全量SQL明细数据。该功能仅支持付费实例。

调试

您可以在API Explorer中调试该接口。

URI

GET /v3/{project_id}/instances/{instance_id}/full-sql-search

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：租户在某一Region下的项目ID。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：只能由英文字母、数字组成，且长度为32个字符。默认取值：不涉及。
instance_id	是	String	参数解释：实例ID。标识实例的唯一标识。约束限制：不涉及。取值范围：只能由英文字母、数字组成，且长度为32个字符。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
start_at	是	Long	开始时间（Unix timestamp），单位：毫秒。
end_at	是	Long	结束时间（Unix timestamp），单位：毫秒。
task_ids	否	Array of long	SQL洞察任务ID列表,时间范围大于1天的SQL洞察任务后台将拆分为多个任务解析,该场景支持多任务过滤导出。
node_id	否	String	节点ID。
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	最小扫描行数。
scan_max	否	Long	最大扫描行数。
affect_min	否	Long	最小影响行数。
affect_max	否	Long	最大影响行数。
return_min	否	Long	最小返回行数。
return_max	否	Long	最大返回行数。
sort_field	否	String	排序字段。 execute_at：执行时间 execute_cost：执行耗时 lock_wait_time：锁等待时间 rows_examined：扫描行数 rows_returned：返回行数
asc	否	Boolean	排序顺序。 true：正序 false：逆序
page	否	Integer	页码。
limit	否	Integer	每页记录数，最大为100。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。
X-Language	否	String	请求语言类型。枚举值： en-us zh-cn

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
full_sql_details	Array of 表5 objects	全量SQL明细列表。
total	Integer	总数。

表5 full_sql_details
参数	参数类型	描述
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。

状态码： 400

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码。最小长度：8 最大长度：36
error_msg	String	错误描述。最小长度：2 最大长度：512

状态码： 500

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码。最小长度：8 最大长度：36
error_msg	String	错误描述。最小长度：2 最大长度：512

请求示例

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	服务器错误。

错误码

请参见错误码。

父主题： 云DBA

上一篇：导出全量SQL

下一篇：查看SQL限流开关状态

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

导出全量SQL明细

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈