取消执行¶

请求取消当前身份仍在运行的 SQL 查询。调用后，查看执行状态确认结果。

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

调用前准备¶

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。
通过能在查询仍运行时返回查询 ID 的执行方式执行 SQL，记录响应中的 query_id。
查看执行状态，确认查询仍在运行。

请求体¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID 和 $QUERY_ID 替换为实际值。

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/query/kill" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d "{\"query_id\": \"$QUERY_ID\"}"

参数说明

参数	类型	是否必填	说明
`query_id`	string	是	要取消的查询 ID。

成功响应¶

成功响应表示取消请求已被接受，不代表查询已在所有运行单元停止。使用查看执行状态确认最终状态。同步执行示例不能提供稳定的取消窗口；产品需要提供异步提交方式，或在其他页面说明如何取得仍在运行的查询 ID。

响应示例

{"code": 200, "data": null}

字段说明

字段	类型	说明
`code`	integer	成功时为 `200`。
`data`	null	此操作不返回数据。

错误响应¶

响应示例

{"code": 404, "message": "SQL 查询不存在"}

字段说明

字段	类型	说明
`code`	integer	错误状态码。
`message`	string	错误信息。

后续操作¶

再次查看执行状态，确认最终状态。

最后更新于 2026 年 9 月 11 日