查询数据库慢日志

功能介绍

查询数据库最近的2000条慢日志信息。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

该接口仅支持MySQL数据库引擎。

URI

• URI格式

  GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/slowlog?start_date={start_date}&end_date={end_date}

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	要查询的实例ID。
  start_date	是	开始日期，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
  end_date	是	结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的慢日志。
  offset	否	页偏移量，如1、2、3、4等，不填时默认为1。
  limit	否	每页多少条记录，取值范围是1~100，不填时默认为10。
  type	否	语句类型，取空值，表示查询所有语句类型，也可指定如下日志类型： INSERT UPDATE SELECT DELETE CREATE

请求消息

无。

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  slow_log_list	Array of objects	具体信息。 详情请参见表3。
  total_record	Integer	总记录数。

  表3 slow_log_list字段数据结构说明

  名称	参数类型	说明
  count	String	执行次数。
  time	String	执行时间。
  lock_time	String	等待锁时间。
  rows_sent	String	结果行数量。
  rows_examined	String	扫描的行数量。
  database	String	所属数据库。
  users	String	帐号。
  query_sample	String	执行语法。
  type	String	语句类型
  start_time	String	发生时间，UTC时间
  client_ip	String	IP地址

• 正常响应样例

  {
      "total_record": 1,
      "slow_log_list": [
          {
              "count": "1",
              "time": "1.04899 s",
              "lock_time": "0.00003 s",
              "rows_sent": "0",
              "rows_examined": "0",
              "database": "mysql",
              "users": "root",
              "query_sample": "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N, @time_zone_id);",
              "type": "INSERT",
              "start_time": "2018-08-06T10:41:14",
              "client_ip": "192.*.*.1"
          }
      ]
  }

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。