查询数据库慢日志 - QueryingTagsofaSpecifiedProject

功能介绍

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

接口约束

该接口只支持GeminiDB Cassandra经典部署模式实例。
该接口只支持查询指定时间区间最近的2000条慢日志。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
gaussdbfornosql:instance:listSlowLog
List
instance *
g:ResourceTag/<tag-key>
g:EnterpriseProjectId
nosql:instance:list
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
gaussdbfornosql:instance:listSlowLog	List	instance *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	nosql:instance:list	-

URI

GET /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指时区偏移量，例如北京时间偏移显示为+0800。开始时间最多不能比当前时间早30天。
end_date	是	String	参数解释：结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的慢日志。结束时间不能晚于当前时间。
offset	否	Integer	参数解释：索引位置，偏移量。取值范围为 [0, 1999]。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。
limit	否	Integer	参数解释：查询记录数。取值范围[1, 100]。并且 limit 与 offset 的和需要满足 <=2000的条件。
node_id	否	String	参数解释：节点ID，取空值，表示查询实例下所有节点。具体取值请参考7.3.3 查询实例列表和详情接口中7.3.3-表 ListInstancesNodeResult中的“id”。
type	否	String	参数解释：语句类型，取空值，表示查询所有语句类型，也可指定如下日志类型： SELECT

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户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	参数解释：语句类型。取值范围： select。
start_time	String	参数解释：发生时间，UTC时间。取值范围：不涉及。

请求示例

URI样例

查询数据库慢日志：

GET https://gaussdb-nosql.cn-north-4.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.cn-north-4.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"
  } ]
}