查询 SQL 执行详情¶

查看一条 SQL 执行记录的完整信息，用于确认语句内容、执行状态、耗时和错误信息。默认只查看当前身份执行的记录。具备相应权限时，可以查看工作区范围的记录。

POST https://api.moi.matrixorigin.cn/v5/query/detail

调用前准备¶

准备有当前工作区访问权限的个人访问令牌和当前工作区 ID。先查询 SQL 执行记录，选择需要分析的记录并记下其语句 ID 和执行时间。

请求体¶

将示例中的 $AI_STUDIO_API_KEY、$WORKSPACE_ID、$STATEMENT_ID 替换为实际值。

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/query/detail" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "statement_id": "'"$STATEMENT_ID"'",
    "start": "2026-08-26T09:44:00Z",
    "end": "2026-08-26T09:46:00Z"
  }'

参数说明

字段	类型	是否必填	说明
`scope`	string 或 null	否	查看当前身份或当前工作区的记录。取值：空字符串、`self`、`workspace`。
`statement_id`	string	是	所选 SQL 执行记录的语句 ID。不能为空。
`start`	string	是	查询开始时间，使用带时区的 RFC 3339 格式。
`end`	string	是	查询结束时间，使用带时区的 RFC 3339 格式。

起止时间使用带时区的 RFC 3339 字符串，例如 2026-08-21T07:00:00Z。详情和计划查询保留输入的本地时间及微秒精度，并将范围前后各扩展 1 秒。列表和概览则转为 UTC 整秒。

查看范围

scope 值	可查看的记录	权限条件。
self	当前身份的记录。	默认范围。
workspace	工作区范围的记录。	需要工作区审计读取权限。

指定查询时间范围

开始和结束时间必须同时填写，并覆盖所选记录的执行时间。例如，列表显示 2026-08-26T09:45:35Z 时，可使用 2026-08-26T09:44:00Z 至 2026-08-26T09:46:00Z 的时间范围。

使用所选执行记录

将所选记录的语句 ID 填入语句 ID 字段。填写开始和结束时间，范围必须覆盖记录的执行时间。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "statement_id": "5c6f22fb-ef0e-4f46-b06f-c31e1a7afb48",
    "transaction_id": "txn-01",
    "session_id": "session-01",
    "account": "acc01",
    "user": "analyst",
    "host": "127.0.0.1",
    "database": "analytics",
    "statement": "SELECT 1 AS n",
    "request_at": "2026-08-26T09:45:35Z",
    "response_at": "2026-08-26T09:45:36Z",
    "duration": 1000000,
    "status": "Success",
    "statement_type": "Select",
    "query_type": "DQL",
    "sql_source_type": "cloud_user_sql",
    "result_count": 1
  }
}

字段说明

字段	类型	说明
`data.statement_id`	string	语句 ID。
`data.transaction_id`	string	事务 ID。
`data.session_id`	string	会话 ID。
`data.account`	string	执行所用账户。
`data.user`	string	执行用户。
`data.host`	string	执行主机。
`data.database`	string	执行时使用的数据库。
`data.statement`	string	SQL 语句文本。
`data.statement_tag`	string	语句标签。
`data.statement_fingerprint`	string	语句指纹。
`data.node_uuid`	string	执行节点 UUID。
`data.node_type`	string	执行节点类型。
`data.request_at`	string	开始执行时间。
`data.response_at`	string	结束执行时间。
`data.duration`	integer	执行时长，单位为纳秒。
`data.status`	string	执行状态。
`data.error_code`	string	错误代码。
`data.error`	string	错误信息。
`data.exec_plan`	string	已保存的执行计划。
`data.rows_read`	integer	读取行数。
`data.bytes_scan`	integer	扫描字节数。
`data.statement_type`	string	语句类型。
`data.query_type`	string	语句类别。
`data.role_id`	integer	执行角色 ID。
`data.sql_source_type`	string	SQL 来源类型。
`data.result_count`	integer	结果行数。
`data.cu`	number	容量使用量。
`data.connection_id`	integer	数据库连接 ID。

需要查看执行计划时，使用相同的语句 ID 和时间范围查询 SQL 执行计划。如需重新执行，确认 SQL 内容、目标数据库和当前身份权限后，使用执行 SQL。

错误响应¶

响应示例

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效"
}

字段说明

字段	类型	说明
code	string	错误代码。
msg	string	错误信息。

最后更新于 2026 年 10 月 19 日