文档首页/ 智能数据湖 AI DataLake/ API参考/ Aura相关API/ AuraSQL作业管理/ 查看SQL执行算子监控记录 - ShowAuraV2StatementOperatorMetrics
更新时间：2026-10-29 GMT+08:00
查看PDF
分享

查看SQL执行算子监控记录 - ShowAuraV2StatementOperatorMetrics

功能介绍

查看SQL执行算子监控记录。

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

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

workspace_id

是

String

参数解释：工作空间的ID。获取方法请参见获取工作空间ID。

约束限制：不涉及。

取值范围：长度为1~36个字符，支持大小写英文字母、数字、连字符。

默认取值：不涉及。

session_id

是

String

参数解释：会话ID。可通过查看Session列表接口获取session_id。

约束限制：不涉及。

取值范围：长度为1~36个字符，支持大小写英文字母、数字、连字符。

默认取值：不涉及。

statement_id

是

String

参数解释：执行语句ID。可通过查看指定Session下的SQL执行记录接口获取statement_id。

约束限制：不涉及。

取值范围：长度为1~36个字符，支持大小写英文字母、数字、下划线、连字符。

默认取值：不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：用户Token，通过调用获取IAM用户Token接口获取。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

[数组元素]

Array of AuraStatementOperatorMetrics objects

参数解释：Aura 算子监控响应结构。
表4 AuraStatementOperatorMetrics

参数

参数类型

描述

session_id

String

参数解释：会话ID。

取值范围：长度为1~36个字符，支持大小写英文字母、数字、连字符。

endpoint_id

String

参数解释：端点ID。

取值范围：长度为1~36个字符，支持大小写英文字母、数字、连字符。

endpoint_name

String

参数解释：端点名称。

取值范围：长度为1~128个字符，支持大小写英文字母、数字、点号、中文、下划线、连字符、空格。

operator_metrics

Array of OperatorMetric objects

参数解释：算子监控信息。

取值范围：不涉及。
表5 OperatorMetric

参数

参数类型

描述

query_id

Long

参数解释：查询ID。

取值范围：1~9223372036854775807。

plan_node_id

Integer

参数解释：节点ID。

取值范围：1~2147483647。

plan_node_name

String

参数解释：节点名称。

取值范围：长度为1~64个字符，支持大小写英文字母、数字、连字符。

start_time

String

参数解释：开始时间，格式为ISO 8601标准时间。例如：2023-05-30T12:24:30.401Z。

取值范围：不涉及

duration

Long

参数解释：执行时长（单位：ms）。

取值范围：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

参数解释：内存使用的最小峰值（单位：MB）。

取值范围：1~2147483647。

max_peak_memory

Integer

参数解释：内存使用的最大峰值（单位：MB）。

取值范围：1~2147483647。

average_peak_memory

Integer

参数解释：内存使用的平均峰值（单位：MB）。

取值范围：1~2147483647。

memory_skew_percent

Integer

参数解释：内存使用倾斜百分比。

取值范围：1~2147483647。

min_spill_size

Integer

参数解释：下盘的最小数据量（单位：MB）。

取值范围：1~2147483647。

max_spill_size

Integer

参数解释：下盘的最大数据量（单位：MB）。

取值范围：1~2147483647。

average_spill_size

Integer

参数解释：下盘的平均数据量（单位：MB）。

取值范围：1~2147483647。

spill_skew_percent

String

参数解释：下盘数据的倾斜百分比。

取值范围：不涉及。

loops

Integer

参数解释：算子执行迭代次数。

取值范围：1~2147483647。

progress

String

参数解释：执行进度百分比。

取值范围：不涉及。

total_read_size

Long

参数解释：所有节点读取的总数据量（单位：MB）。

取值范围：1~9223372036854775807。

total_write_size

Long

参数解释：所有节点写入的总数据量（单位：MB）。

取值范围：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-xxxx-xxxx-a02a5a823a44",
  "endpoint_id" : "019ecb4f-84b8-xxxx-xxxx-3554291ff8ee",
  "endpoint_name" : "aura-endpoint",
  "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" : 1,
    "min_peak_memory" : 1,
    "max_peak_memory" : 10000,
    "average_peak_memory" : 3000,
    "memory_skew_percent" : 1,
    "min_spill_size" : 1,
    "max_spill_size" : 10000,
    "average_spill_size" : 3000,
    "spill_skew_percent" : "0%",
    "loops" : 200,
    "progress" : "0.00%",
    "total_read_size" : 20000,
    "total_write_size" : 30000,
    "sub_operator_metrics" : [ {
      "query_id" : 132011764077297660,
      "plan_node_id" : 1,
      "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" : 1,
      "min_peak_memory" : 1,
      "max_peak_memory" : 10000,
      "average_peak_memory" : 3000,
      "memory_skew_percent" : 1,
      "min_spill_size" : 1,
      "max_spill_size" : 10000,
      "average_spill_size" : 3000,
      "spill_skew_percent" : "0%",
      "loops" : 200,
      "progress" : "0.00%",
      "total_read_size" : 20000,
      "total_write_size" : 30000,
      "sub_operator_metrics" : [ ]
    } ]
  }, {
    "query_id" : 132011764077297859,
    "plan_node_id" : 1,
    "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" : 1,
    "min_peak_memory" : 1,
    "max_peak_memory" : 10000,
    "average_peak_memory" : 3000,
    "memory_skew_percent" : 1,
    "min_spill_size" : 1,
    "max_spill_size" : 10000,
    "average_spill_size" : 3000,
    "spill_skew_percent" : "0%",
    "loops" : 200,
    "progress" : "0.00%",
    "total_read_size" : 20000,
    "total_write_size" : 30000,
    "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",
  "solution_msg" : "Please obtain a valid token and retry."
}

状态码：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 does not exist.",
  "solution_msg" : "Please try to use correct info."
}

状态码：408

{
  "error_code" : "common.00000408",
  "error_msg" : "A timeout exception occurred.",
  "solution_msg" : "The request timed out while waiting for a response — check the backend service status and network, then retry; if the operation is long-running, increase the client timeout or split the request."
}

状态码：500

{
  "error_code" : "common.00000500",
  "error_msg" : "internal error",
  "solution_msg" : "An internal service error occurred. Please retry later; if the problem persists, contact technical support."
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

401

未经授权。

403

请求被拒绝访问。

404

所请求的资源不存在。

408

请求超时。

500

服务器内部错误。
父主题： AuraSQL作业管理

相关文档