
# 查询数据库慢日志
#### 接口说明
查询数据库慢日志信息。
![](https://support.huaweicloud.com/api-dds/public_sys-resources/notice_3.0-zh-cn.png)
该接口计划于2025-03-31下线，建议及时切换到新接口[查询数据库慢日志（新版）-QueryingDatabaseSlowLogs(New)](https://support.huaweicloud.com/api-dds/dds_api_0093.html)。
#### 约束说明
在入参start_date和end_date的时间段内最多查询到2000条数据。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDS&api=ListSlowLogs)中调试该接口。
#### URI
- URI格式 GET /v3/{project_id}/instances/{instance_id}/slowlog
  
- URI样例
  - 查询数据库慢日志： https://dds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog?start_date=2018-08-06T10:41:14+0800\&end_date=2018-08-07T10:41:14+0800
    
  
  - 根据指定条件查询数据库慢日志： https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog?type=INSERT\&offset=1\&limit=20\&node_id=a7c84462483642798cf159237343135fno06\&start_date=2018-08-06T10:41:14+0800\&end_date=2018-08-07T10:41:14+0800
    
   
 
表1参数说明 
| 名称           | 类型      | 是否必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | String  | 是    | 从IAM服务获取的用户Token。请参考[认证鉴权](https://support.huaweicloud.com/api-dds/dds_api_0010.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| project_id   | String  | 是    | 租户在某一Region下的项目ID。请参考[获取项目ID](https://support.huaweicloud.com/api-dds/dds_projectid.html)章节获取项目编号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| instance_id  | String  | 是    | 实例ID，可以调用"查询实例列表"接口获取。如果未申请实例，可以调用"创建实例"接口创建。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| start_date   | String  | 是    | 开始时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始，Z指时区偏移量，例如北京时间偏移显示为+0800。 注意： 开始时间早于当前时间31天。                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| end_date     | String  | 是    | 结束时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 只能查询当前时间前一个月内的慢日志。 说明： 结束时间不能晚于当前时间。                                                                                                                                                                                                                                                                                                                                                                                |
| node_id      | String  | 否    | 节点ID，请参考[表9](https://support.huaweicloud.com/api-dds/dds_api_0023.html#dds_api_0023__table3426155424213)的"id"。 取空值，表示查询实例下所有允许查询的节点。 允许查询的节点如下： 集群实例下面的 shard节点。 副本集、单节点实例下面的所有节点。                                                                                                                                                                                                                                                                                                              |
| type         | String  | 否    | 语句类型，取空值，表示查询所有语句类型，也可指定如下日志类型： - INSERT  - QUERY  - UPDATE  - REMOVE  - GETMORE  - COMMAND  - KILLCURSORS   |
| offset       | Integer | 否    | 索引位置，偏移量。取值范围为 \[0, 1999\]。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| limit        | Integer | 否    | 查询记录数。取值范围\[1, 100\]，默认10 （表示默认返回10条数据）。 说明： limit 与 offset 的和需要满足小于等于2000的条件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
#### 请求消息
无。
#### 响应消息
- 参数说明
  表2参数说明 
  | 名称            | 参数类型             | 说明                                                                             |
  |:---|:---|:---|
  | slow_log_list | Array of objects | 具体信息。 详情请参见[表3]。 |
  | total_record  | Integer          | 总记录数。                                                                          |
     
   表3slow_log_list字段数据结构说明 
  | 名称            | 参数类型   | 说明          |
  |:---|:---|:---|
  | node_name     | String | 节点名称。       |
  | query_sample  | String | 执行语法。       |
  | type          | String | 语句类型。       |
  | time          | String | 执行时间。       |
  | lock_time     | String | 等待锁时间。      |
  | rows_sent     | String | 结果行数量。      |
  | rows_examined | String | 扫描的行数量。     |
  | database      | String | 所属数据库。      |
  | start_time    | String | 发生时间，UTC时间。 |
     
  
 
- 响应示例
  ```
  {
    "slow_log_list": [
      {
        "node_name": "Test_replica_node_2",
        "query_sample": "{\"responseLength\": 230, \"ts\": {\"$date\": 1605480486800}, \"ninserted\": 1, \"locks\": {\"oplog\": {\"acquireCount\": {\"w\": 1}}, \"Global\": {\"acquireCount\": {\"r\": 3, \"w\": 2}}, \"Collection\": {\"acquireCount\": {\"w\": 2}}, \"Database\": {\"acquireCount\": {\"w\": 3}}}, \"numYield\": 0, \"ns\": \"geographySpace.tiles\"}",
        "type": "REMOVE",
        "time": "101 ms",
        "lock_time": "10 us",
        "rows_sent": "0",
        "rows_examined": "0",
        "database": "geography",
        "start_time": "2020-11-15T22:49:38.643000Z"
      }
    ],
    "total_record": 1
  }
  ```
  
#### SDK
单击[文档数据库服务 DDS SDK](https://sdkcenter.developer.huaweicloud.com/?product=DDS)，下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
#### 状态码
详情请参见[状态码](https://support.huaweicloud.com/api-dds/dds_status_code.html)。
#### 错误码
详情请参见[错误码](https://support.huaweicloud.com/api-dds/dds_error_code.html)。
