文档首页/ 云数据库 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}/global-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的SQL ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

node_ids

是

Array of strings

参数解释：

节点ID集合。

约束限制：

节点ID数组不能为空。

component_type

是

String

参数解释：

组件类型。

约束限制：

不涉及。

取值范围：

  • cn：CN组件类型。
  • dn：DN组件类型。

默认取值：

不涉及。

响应参数

表4 响应Body参数

参数

参数类型

描述

total

Integer

参数解释：

慢SQL总条数。

取值范围：

不涉及。

slow_sql_details

Array of objects

参数解释：

慢SQL详情信息列表。详情请参见表5。
表5 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/global-slow-sql-detail
{
    "instance_id" : "d04686c6baae4f65a742771186f47b7ain14",
    "node_ids" : [ "88391813e1cb4e93899b210e880fdb1bno20" ],
    "start_time" : 1686903754933,
    "end_time" : 1686990154933,
    "sql_id" : 123,
    "component_type" : "dn"
}

响应示例

查询慢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

相关文档