文档中心

数据库工作台

SQL 洞察与审计

DescribeSQLExecItemMetric

DescribeSQLExecItemMetric

调用 DescribeSQLExecItemMetric 接口查询某个 SQL 指纹在指定时间范围内的单项执行指标曲线。

请求类型

同步请求。

请求参数

名称	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-cf8d83******	实例 ID。说明您可以按需选择以下接口查询实例 ID：调用 DescribeDBInstances 接口查询 MySQL 的实例 ID。调用 DescribeDBInstances 接口查询 veDB MySQL 的实例 ID。调用 DescribeDBInstances 接口查询 PostgreSQL 的实例 ID。
InstanceType	String	是	MySQL	数据库类型，当前支持的数据库如下所示。 MySQL：云数据库 MySQL 版。 VeDBMySQL：云数据库 veDB MySQL 版。 Postgres：云数据库 PostgresSQL 版。
StartTime	Integer	是	1719820800	查询开始时间，使用秒级时间戳。
EndTime	Integer	是	1719824400	查询结束时间，使用秒级时间戳。
ItemType	String	是	ExecTime	查询的指标类型。取值如下： count：表示 SQL 执行次数。 ExecTime：表示 SQL 执行耗时。 RowsAffected：表示影响行数。 RowsSent：表示返回行数。
RegionId	String	是	cn-beijing	地域 ID。
SqlFingerprint	String	是	a1b2c3d4	SQL 指纹。
NodeId	String	否	node-a	节点 ID 过滤条件。传入该参数后按按照节点维度聚合。
DbName	String	否	order_db	数据库名过滤条件。

返回参数

名称	类型	示例值	描述
DataPoints	Array of DataPoint	[ { "Abnormal": 0, "TimeStamp": 1787541550, "Value": 0 }, { "Abnormal": 0, "TimeStamp": 1787627086, "Value": 2 } ]	指标曲线数据点列表。

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.09.01 14:02:02

这个页面对您有帮助吗？

有用

有用

无用

无用