# 查看语句监控详情 - ShowAuraV2StatementQueryMetrics
#### 功能介绍
查询语句监控详情信息。
输入workspace_id，session_id，statement_id，输出此会话下SQL监控数据。
此接口为同步接口，无配套使用接口和特殊场景。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-aidatalake/aidatalake_02_0003.html)。
#### 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 | **参数解释**：语句监控详情。 |
   
 表4StatementQueryMetrics 
| 参数                           | 参数类型    | 描述                                                                                                       |
|:---|:---|:---|
| 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 | 服务器内部错误。   |