# 查看SQL执行算子监控记录 - ShowAuraV2StatementOperatorMetrics #### 功能介绍 查看SQL执行算子监控记录。 用户可通过该接口查看SQL执行算子监控记录，输入为SQL Session id、statement id，返回操作结果。 此接口为同步接口，无配套使用接口和特殊场景。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-aidatalake/aidatalake_02_0003.html)。 #### URI GET /v2/workspaces/{workspace_id}/aura-sessions/{session_id}/statements/{statement_id}/operator-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 [AuraStatementOperatorMetrics] objects | **参数解释**：Aura Job V2 算子监控响应结构。 | 表4AuraStatementOperatorMetrics | 参数 | 参数类型 | 描述 | |:---|:---|:---| | session_id | String | **参数解释**：会话id。 **取值范围**：长度为1\~36个字符，支持大小写英文字母、数字、连字符。 | | statement_id | String | **参数解释**：语句id。 **取值范围**：长度为1\~36个字符，支持大小写英文字母、数字、连字符。 | | endpoint_id | String | **参数解释**：端点id。 **取值范围**：长度为1\~36个字符，支持大小写英文字母、数字、连字符。 | | operator_metrics | Array of [OperatorMetric] objects | **参数解释**：算子监控信息。 **取值范围**：不涉及。 | 表5OperatorMetric | 参数 | 参数类型 | 描述 | |:---|:---|:---| | query_id | Long | **参数解释**：查询ID。 **取值范围**：1\~9223372036854775807。 | | plan_node_id | Integer | **参数解释**：节点ID。 **取值范围**：1\~2147483647。 | | plan_node_name | String | **参数解释**：节点名称。 **取值范围**：长度为1\~64个字符，支持大小写英文字母、数字、连字符。 | | start_time | String | **参数解释**：开始时间，格式为：YYYY-MM-DD HH:MM:SS。 **取值范围**：时间范围：1000-01-01 00:00:00/9999-12-31 23:59:59。 | | duration | Long | **参数解释**：执行时长。 **取值范围**：1\~9223372036854775807。 | | status | String | **参数解释**：开始时间当前状态。 **取值范围**： - init：初始化。 - waiting：等待中。 - finished：已结束。 - running：运行中。 | | query_dop | Integer | **参数解释**：查询的并行度。 **取值范围**：1\~2147483647。 | | estimated_rows | Long | **参数解释**：预估的行数。 **取值范围**：1\~9223372036854775807。 | | tuple_processed | Long | **参数解释**：当前已经处理完成的行数。 **取值范围**：1\~9223372036854775807。 | | min_peak_memory | Integer | **参数解释**：内存使用的最小峰值。 **取值范围**：1\~2147483647。 | | max_peak_memory | Integer | **参数解释**：内存使用的最大峰值。 **取值范围**：1\~2147483647。 | | average_peak_memory | Integer | **参数解释**：内存使用的平均峰值。 **取值范围**：1\~2147483647。 | | memory_skew_percent | Integer | **参数解释**：内存使用倾斜百分比。 **取值范围**：1\~2147483647。 | | min_spill_size | Integer | **参数解释**：下盘的最小数据量。 **取值范围**：1\~2147483647。 | | max_spill_size | Integer | **参数解释**：下盘的最大数据量。 **取值范围**：1\~2147483647。 | | average_spill_size | Integer | **参数解释**：下盘的平均数据量。 **取值范围**：1\~2147483647。 | | spill_skew_percent | String | **参数解释**：下盘数据的倾斜百分比。 **取值范围**：不涉及。 | | loops | Integer | **参数解释**：算子执行迭代次数。 **取值范围**：1\~2147483647。 | | progress | String | **参数解释**：执行进度百分比。 **取值范围**：不涉及。 | | total_read_size | Long | **参数解释**：所有节点读取的总数据量。 **取值范围**：1\~9223372036854775807。 | | total_write_size | Long | **参数解释**：所有节点写入的总数据量。 **取值范围**：1\~9223372036854775807。 | | sub_operator_metrics | Array of [OperatorMetric] objects | **参数解释**：子节点。 **取值范围**：不涉及。 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~4096个字符。 | | solution_msg | String | **参数解释**：解决方案描述。 **取值范围**：长度为2\~4096个字符。 | **状态码：401** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~4096个字符。 | | solution_msg | String | **参数解释**：解决方案描述。 **取值范围**：长度为2\~4096个字符。 | **状态码：403** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~4096个字符。 | | solution_msg | String | **参数解释**：解决方案描述。 **取值范围**：长度为2\~4096个字符。 | **状态码：404** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~4096个字符。 | | solution_msg | String | **参数解释**：解决方案描述。 **取值范围**：长度为2\~4096个字符。 | **状态码：408** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~4096个字符。 | | solution_msg | String | **参数解释**：解决方案描述。 **取值范围**：长度为2\~4096个字符。 | **状态码：500** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：错误码。 **取值范围**：长度为8\~36个字符。 | | error_msg | String | **参数解释**：错误描述。 **取值范围**：长度为2\~4096个字符。 | | solution_msg | String | **参数解释**：解决方案描述。 **取值范围**：长度为2\~4096个字符。 | #### 请求示例 查询SQL执行算子监控记录。 ``` GET /v2/workspaces/{workspace_id}/aura-sessions/{session_id}/statements/{statement_id}/operator-metrics { } ``` #### 响应示例 **状态码：200** 请求成功。 ``` { "session_id" : "019ecb4f-0662-7689-b348-a02a5a823a44,", "statement_id" : "019ecb4f-84b8-7f34-8475-3554291ff8ee,", "operator_metrics" : [ { "query_id" : 132011764077297660, "plan_node_id" : 1, "plan_node_name" : "Row Adapter", "start_time" : "2026-06-15T12:44:06.755+00:00", "duration" : 20032, "status" : "running", "query_dop" : 1, "estimated_rows" : 1, "tuple_processed" : 0, "min_peak_memory" : 0, "max_peak_memory" : 0, "average_peak_memory" : 0, "memory_skew_percent" : 0, "min_spill_size" : 0, "max_spill_size" : 0, "average_spill_size" : 0, "spill_skew_percent" : "0%", "loops" : 0, "progress" : "0.00%", "total_read_size" : 0, "total_write_size" : 0, "sub_operator_metrics" : [ { "query_id" : 132011764077297660, "plan_node_id" : 2, "plan_node_name" : "Vector Result", "start_time" : "‘2026-06-15T12:44:06.755+00:00'", "duration" : 20032, "status" : "running", "query_dop" : 1, "estimated_rows" : 1, "tuple_processed" : 0, "min_peak_memory" : 0, "max_peak_memory" : 0, "average_peak_memory" : 0, "memory_skew_percent" : 0, "min_spill_size" : 0, "max_spill_size" : 0, "average_spill_size" : 0, "spill_skew_percent" : "0%", "loops" : 0, "progress" : "0.00%", "total_read_size" : 0, "total_write_size" : 0, "sub_operator_metrics" : [ ] } ] } ] } ``` **状态码：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 | 服务器内部错误。 |