查看语句监控详情 - ShowAuraV2StatementQueryMetrics

功能介绍

查询语句监控详情信息。

输入workspace_id，session_id，statement_id，输出此会话下SQL监控数据。

此接口为同步接口，无配套使用接口和特殊场景。

调用方法

请参见如何调用API。

URI

GET /v2/workspaces/{workspace_id}/aura-sessions/{session_id}/statements/{statement_id}/query-metrics

表1 路径参数
参数	是否必选	参数类型	描述
workspace_id	是	String	参数解释：工作空间的ID。约束限制：不涉及。取值范围：长度为1~36个字符，支持大小写英文字母、数字、连字符。默认取值：不涉及。
session_id	是	String	参数解释：会话ID。约束限制：不涉及。取值范围：长度为1~36个字符，支持大小写英文字母、数字、连字符。默认取值：不涉及。
statement_id	是	String	参数解释：statement id。约束限制：不涉及。取值范围：长度为1~36个字符，支持大小写英文字母、数字、下划线。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：租户token。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
[数组元素]	Array of StatementQueryMetrics objects	参数解释：语句监控详情。

表4 StatementQueryMetrics
参数	参数类型	描述
session_id	String	参数解释：会话ID。取值范围：长度为1~36个字符，支持大小写英文字母、数字、连字符。
statement_id	String	参数解释：语句ID。取值范围：不涉及。
start_time	String	参数解释：语句开始时间。取值范围：不涉及。
duration	Long	参数解释：语句运行时长（单位：ms）。取值范围：不涉及。
schema_name	String	参数解释：语句执行时的Schema名称。取值范围：不涉及。
query	String	参数解释：查询语句。取值范围：不涉及。
query_plan	String	参数解释：语句计划信息。取值范围：不涉及。
estimate_total_time	Long	参数解释：预计语句运行时长（单位：ms）。取值范围：不涉及。
estimate_left_time	Long	参数解释：预计语句剩余时长（单位：ms）。取值范围：不涉及。
startup_coordinator_duration	Long	参数解释：cn启动时长（单位：ms）。取值范围：不涉及。
create_session_duration	Long	参数解释：创建会话时长（单位：ms）。取值范围：不涉及。
enqueue_statement_duration	Long	参数解释：语句加入任务队列时长（单位：ms）。取值范围：不涉及。
queue_duration	Long	参数解释：语句排队时长（单位：ms）。取值范围：不涉及。
write_resultset_duration	Long	参数解释：语句写结果集时长（单位：ms）。取值范围：不涉及。
parse_time	Long	参数解释：执行前解析时间（单位：ms）。取值范围：不涉及。
estimate_memory	Integer	参数解释：预计使用内存（单位：MB）。取值范围：不涉及。
status	String	参数解释：语句状态，WLM状态。取值范围：不涉及。
error_info	String	参数解释：语句报错信息。取值范围：不涉及。
dn_time_skew_percent	Integer	参数解释：DN时长偏斜百分比（单位：%）。取值范围：不涉及。
dn_max_peak_memory	Integer	参数解释：DN最大峰值内存（单位：MB）。取值范围：不涉及。
dn_average_peak_memory	Integer	参数解释：DN平均峰值内存（单位：MB）。取值范围：不涉及。
dn_spill_skew_percent	Integer	参数解释：dn下盘倾斜率（单位：%）。取值范围：不涉及。
dn_write_disk_total_size	Long	参数解释：dn落盘总大小（单位：MB）。取值范围：不涉及。
dn_spill_obs_total_size	Long	参数解释：dn溢写OBS总大小（单位：MB）。取值范围：不涉及。
cn_spill_obs_size	Long	参数解释：cn溢写OBS大小（单位：MB）。取值范围：不涉及。
disk_cache_hit_ratio	Number	参数解释：磁盘缓存命中率。取值范围：不涉及。
obs_io_req_avg_latency	Long	参数解释：OBS IO请求平均延迟（单位：us）。取值范围：不涉及。
obs_io_req_latency_gt_1s	Long	参数解释：OBS IO请求延迟大于1秒的次数。取值范围：不涉及。
obs_io_req_latency_gt_10s	Long	参数解释：OBS IO请求延迟大于10秒的次数。取值范围：不涉及。

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~4096个字符。
solution_msg	String	参数解释：解决方案描述。取值范围：长度为2~4096个字符。

状态码：401

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~4096个字符。
solution_msg	String	参数解释：解决方案描述。取值范围：长度为2~4096个字符。

状态码：403

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~4096个字符。
solution_msg	String	参数解释：解决方案描述。取值范围：长度为2~4096个字符。

状态码：404

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~4096个字符。
solution_msg	String	参数解释：解决方案描述。取值范围：长度为2~4096个字符。

状态码：408

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~4096个字符。
solution_msg	String	参数解释：解决方案描述。取值范围：长度为2~4096个字符。

状态码：500

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为8~36个字符。
error_msg	String	参数解释：错误描述。取值范围：长度为2~4096个字符。
solution_msg	String	参数解释：解决方案描述。取值范围：长度为2~4096个字符。

请求示例

查询语句监控详情信息。

GET /v2/workspaces/{workspace_id}/aura-sessions/{session_id}/statements/{statement_id}/query-metrics

{ }

响应示例

状态码：200

请求成功。

[ {
  "session_id" : "019ebf09-9043-7712-b2f5-457c448921da",
  "statement_id" : "019ebf09-ed4d-7cfe-a577-c752b9a9962c",
  "start_time" : "2026-06-13T03:32:39.386Z",
  "duration" : 30168,
  "schema_name" : "default_db",
  "query" : "SELECT write_to_file1212('/work_dir/actor_share/019ebf09-9043-7712-b2f5-457c448921da/1234.txt','***') WITH ARGUMENTS(cpu=0.33, memory=128);",
  "query_plan" : "",
  "startup_coordinator_duration" : 531,
  "create_session_duration" : 12,
  "enqueue_statement_duration" : 0,
  "queue_duration" : 0,
  "write_resultset_duration" : 0,
  "parse_time" : 76,
  "estimate_memory" : 4096,
  "status" : "SUCCESSFUL",
  "error_info" : "",
  "dn_time_skew_percent" : 0,
  "dn_max_peak_memory" : 0,
  "dn_average_peak_memory" : 0,
  "dn_spill_skew_percent" : 0,
  "dn_write_disk_total_size" : 0,
  "dn_spill_obs_total_size" : 0,
  "cn_spill_obs_size" : 0,
  "disk_cache_hit_ratio" : 0,
  "obs_io_req_avg_latency" : 0,
  "obs_io_req_latency_gt_1s" : 0,
  "obs_io_req_latency_gt_10s" : 0
} ]

状态码：400

非法请求。

{
  "error_code" : "AIDataLake.00092031",
  "error_msg" : "Invalid parameter name",
  "solution_msg" : "Please enter parameters in the correct format."
}

状态码：401

未经授权。

{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed"
}

状态码：403

请求被拒绝访问。

{
  "error_code" : "AIDataLake.00090030",
  "error_msg" : "Unauthorized requests.",
  "solution_msg" : "Check permissions and retry after authorization."
}

状态码：404

所请求的资源不存在。

{
  "error_code" : "AIDataLake.00090009",
  "error_msg" : "The resource not exists.",
  "solution_msg" : "Please try to use correct info."
}

状态码：408

请求超时。

{
  "error_code" : "common.00000408",
  "error_msg" : "timeout exception occurred"
}

状态码：500

服务器内部错误。

{
  "error_code" : "common.00000500",
  "error_msg" : "internal error"
}

状态码

状态码	描述
200	请求成功。
400	非法请求。
401	未经授权。
403	请求被拒绝访问。
404	所请求的资源不存在。
408	请求超时。
500	服务器内部错误。