文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 慢SQL/ 查询慢SQL详情
更新时间：2025-09-11 GMT+08:00
查看PDF
分享

查询慢SQL详情

功能介绍

根据归一化SQLID，查询该SQL模板详情。

调试

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

接口约束

仅支持包含有CN或DN（主、备）组件的节点。

URI

POST /v3/{project_id}/instances/{instance_id}/slow-sql-detail

表1 参数说明

名称

是否必选

说明

project_id

是

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

参数解释：

实例ID，此参数是用户创建实例的唯一标识。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为36个字符。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Language

否

String

参数解释：

语言。

约束限制：

不涉及。

取值范围：

  • zh-cn
  • en-us

默认取值：

en-us。
表3 请求Body参数

参数

是否必选

参数类型

描述

start_time

是

Long

参数解释：

起始日期。

约束限制：

13位UNIX时间戳格式，单位是毫秒，时区是UTC。

取值范围：

不涉及。

默认取值：

不涉及。

end_time

是

Long

参数解释：

结束日期。

约束限制：

13位UNIX时间戳格式，单位是毫秒，时区是UTC。

取值范围：

不涉及。

默认取值：

不涉及。

instance_id

是

String

参数解释：

实例ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

sql_id

是

String

参数解释：

慢SQL的sqlid。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

node_ids

是

Array of strings

参数解释：

节点ID。

约束限制：

不能为空。

multi_queries

否

Array of MultiMergeCondition

参数解释：

字段汇聚查询条件列表。

详情请参见表4。

约束限制：

只支持针对query字段全与或者全或的查询。
表4 MultiMergeCondition

参数

参数类型

描述

name

String

参数解释：

查询字段名称。

约束限制：

只支持字符串"query"。

取值范围：

由英文字母（大小写）、数字或下划线组成，长度为 1 至 128 个字符。

默认取值：

不涉及。

condition

String

参数解释：

合并条件。

约束限制：

不涉及。

取值范围：

仅限字符串："and"、"or"、"AND"、"OR"。

默认取值：

不涉及。

values

Array of strings

参数解释：

多个过滤检索条件内容集合。由 1 至 5 个字符串组成的列表。

约束限制：

不涉及。

isFuzzy

Boolean

参数解释：

多个过滤检索条件内容集合。

约束限制：

只支持为true进行模糊查询。

取值范围：

  • true 表示模糊查询。
  • false 表示精确匹配。

默认取值：

true

响应参数

表5 响应Body参数

参数

参数类型

描述

total

Integer

参数解释：

总条数。

取值范围：

不涉及。

slow_sql_details

Array of objects

参数解释：

慢SQL详情信息列表。详情请参见表6。
表6 SlowSqlDetails

参数

参数类型

描述

db_name

String

参数解释：

数据库名称。

取值范围：

不涉及。

schema_name

String

参数解释：

SCHEMA名称。

取值范围：

不涉及。

sql_id

String

参数解释：

SQL ID。

取值范围：

不涉及。

user_name

String

参数解释：

用户名称。

取值范围：

不涉及。

client_ip

String

参数解释：

客户端IP。

取值范围：

不涉及。

client_port

String

参数解释：

客户端端口。

取值范围：

不涉及。

node_id

String

参数解释：

节点ID。

取值范围：

不涉及。

node_name

String

参数解释：

节点名称。

取值范围：

不涉及。

sql_text

String

参数解释：

SQL模板。

取值范围：

不涉及。

sql

String

参数解释：

变量替换后的完整SQL。当sql_text不返回变量值时，sql返回空字符串。

取值范围：

不涉及。

query_plan

String

参数解释：

执行计划。

取值范围：

不涉及。

start_time

Integer

参数解释：

开始时间UTC时间，格式为yyyy-mm-ddThh:mm:ss+0000。

取值范围：

不涉及。

finish_time

Integer

参数解释：

结束时间UTC时间，格式为yyyy-mm-ddThh:mm:ss+0000。

取值范围：

不涉及。

returned_rows

Integer

参数解释：

返回行。

取值范围：

不涉及。

fetched_rows

Integer

参数解释：

扫描行。

取值范围：

不涉及。

fetched_pages

Integer

参数解释：

扫描页。

取值范围：

不涉及。

hit_pages

Integer

参数解释：

命中页。

取值范围：

不涉及。

total_time

Integer

参数解释：

总耗时（单位：微秒）。

取值范围：

不涉及。

cpu_time

Integer

参数解释：

CPU耗时（单位：微秒）。

取值范围：

不涉及。

plan_time

Integer

参数解释：

计划耗时（单位：微秒）。

取值范围：

不涉及。

io_time

Integer

参数解释：

IO耗时（单位：微秒）。

取值范围：

不涉及。

lock_count

Integer

参数解释：

加锁次数。

取值范围：

不涉及。

lock_time

Integer

参数解释：

加锁耗时(单位：微秒)。

取值范围：

不涉及。

请求示例

查询慢SQL详情。

POST https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0611f1bd8b00d5d32f17c017f15b599f/instances/d04686c6baae4f65a742771186f47b7ain14/slow-sql-detail
{
    "instance_id" : "d04686c6baae4f65a742771186f47b7ain14",
    "node_ids" : [ "88391813e1cb4e93899b210e880fdb1bno20" ],
    "start_time" : 1686903754933,
    "end_time" : 1686990154933,
    "sql_id" : 123,
    "multi_queries": [ { "name": "query", "condition": "AND", "is_fuzzy": true, "values": [ "slelect", "from table" ] } ]
}

响应示例

查询慢SQL详情成功。

{ 
  "slow_sql_details" : [ { 
    "db_name": "db_tpcc",
    "schema_name": "db_tpcc",
    "sql_id" : "12345", 
    "user_name" : "john_doe", 
    "client_ip" : "192.168.0.1", 
    "client_port" : "5432", 
    "sql_text" : "SELECT * FROM large_table WHERE column1 = 'value';", 
    "sql" : "",
    "query_plan" : "Seq Scan on large_table ...", 
    "start_time" : "2024-03-26 11:23:47 +0000", 
    "finish_time" : "2024-03-26 11:23:51 +0000", 
    "returned_rows" : 1000, 
    "fetched_rows" : 5000, 
    "fetched_pages" : 50, 
    "hit_pages" : 25, 
    "total_time" : "79.2812", 
    "cpu_time" : "0.0170", 
    "plan_time" : "0.0001", 
    "io_time" : "0.0045", 
    "lock_count" : 1, 
    "lock_time" : "0.0000", 
    "node_id" : "88391813e1cb4e93899b210e880fdb1bno20", 
    "node_name" : "Node1" 
  } ], 
  "total" : 1 
}

状态码

错误码

请参见错误码。

父主题： 慢SQL

相关文档