本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
取消 SPARQL 查询
要获取 SPARQL 查询的状态,请使用 HTTP GET
或 POST
来向 https://
终端节点提出请求。your-neptune-endpoint
:port
/sparql/status
SPARQL 查询取消请求参数
cancelQuery
(必需)告知状态命令取消查询。该参数不接收值。
queryId
(必需)要取消的正在运行的 SPARQL 查询的 ID。
silent
(可选)如果 silent=true
,则取消正在运行的查询,并且 HTTP 响应代码为 200。如果不存在 silent
或 silent=false
,则取消查询,并且返回 HTTP 500 状态代码。
SPARQL 查询取消示例
示例 1:在 silent=false
的情况下取消
以下是在将 silent
参数设置为 false
的情况下使用 curl
取消查询的状态命令的示例:
curl https://
your-neptune-endpoint
:port
/sparql/status \ -d "cancelQuery" \ -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47" \ -d "silent=false"
除非查询已开始流式传输结果,否则取消的查询将返回一个 HTTP 500 代码,其响应如下:
{ "code": "CancelledByUserException", "requestId": "4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47", "detailedMessage": "Operation terminated (cancelled by user)" }
如果查询返回了一个 HTTP 200 代码 (OK),并且在取消之前已开始流式传输结果,则超时异常信息将发送到常规输出流。
示例 2:在 silent=true
的情况下取消
以下状态命令与上面的示例相同,但在本示例中,silent
参数设置为 true
:
curl https://
your-neptune-endpoint
:port
/sparql/status \ -d "cancelQuery" \ -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47" \ -d "silent=true"
该命令将返回与 silent=false
时相同的响应,但这次取消的查询将返回 HTTP 200 代码,其响应如下:
{ "head" : { "vars" : [ "s", "p", "o" ] }, "results" : { "bindings" : [ ] } }