更新时间:2024-08-08 GMT+08:00

查询数据库慢日志

功能介绍

查询数据库最近的2000条慢日志信息,暂不支持关键字搜索。

接口约束

  • 该接口支持GeminiDB Cassandra数据库实例。
  • 该接口只支持查询指定时间区间最近的2000条慢日志。

URI

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/slowlog

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。获取方法请参见获取项目ID

instance_id

String

实例ID。

表2 Query参数

参数

是否必选

参数类型

描述

start_date

String

开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。

其中,T指某个时间的开始;Z指时区偏移量。

开始时间最多不能比当前时间早30天。

end_date

String

结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”。

其中,T指某个时间的开始;Z指时区偏移量。只能查询当前时间前一个月内的慢日志。

结束时间不能晚于当前时间。

offset

Integer

索引位置,偏移量。取值范围为 [0, 1999]。

从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。

limit

Integer

查询记录数。取值范围[1, 100]。

并且 limit 与 offset 的和需要满足 <= 2000的条件。

node_id

String

节点ID,取空值,表示查询实例下所有节点。

具体取值请参考5.3.3 查询实例列表和详情接口中5.3.3-表 ListInstancesNodeResult中的“id”。

type

String

语句类型,取空值,表示查询所有语句类型,也可指定如下日志类型:

  • SELECT

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

slow_log_list

Array of SlowlogResult objects

具体信息。

total_record

Integer

总记录数。

表5 SlowlogResult

参数

参数类型

描述

time

String

执行时间。

database

String

所属数据库。

query_sample

String

执行语法。

type

String

语句类型。

start_time

String

发生时间,UTC时间。

请求示例

  • URI样例

    查询数据库慢日志:

    GET https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/6ade8143870047b8999aba8f1891b48ein06/slowlog?start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800
  • URI样例

    根据指定条件查询数据库慢日志:

    GET https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/6ade8143870047b8999aba8f1891b48ein06/slowlog?type=SELECT&offset=1&limit=20&node_id=a7c84462483642798cf159237343135fno06&start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800

响应示例

状态码: 200

Success

{
  "total_record" : 1,
  "slow_log_list" : [ {
    "time" : "513 ms",
    "database" : "cassandra",
    "query_sample" : "SELECT * FROM cassandra.sz_user LIMIT 100;",
    "type" : "SELECT",
    "start_time" : "2020-11-15T22:49:38.643000Z"
  } ]
}

状态码

请参见状态码

错误码

请参见错误码