本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

SPARQL 查詢取消

若要取得SPARQL查詢的狀態，請使用 HTTPGET或 向https://your-neptune-endpoint:port/sparql/status端點POST提出請求。

SPARQL 查詢取消請求參數

cancelQuery

(必要) 告知狀態命令取消查詢。此參數不採用數值。

queryId

（必要） 要取消的執行中SPARQL查詢 ID。

silent

（選用） 如果接著取消執行silent=true中的查詢，且HTTP回應碼為 200。如果 silent 不存在 或 silent=false，則會使用 HTTP 500 狀態碼取消查詢。

SPARQL 查詢取消範例

範例 1：描配 silent=false 進行取消

以下是使用狀態命令的範例，其使用 curl 搭配設定為 false 的 silent 參數來取消查詢：

curl https://your-neptune-endpoint:port/sparql/status \
  -d "cancelQuery" \
  -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47" \
  -d "silent=false"

除非查詢已開始串流結果，否則取消的查詢會傳回 500 HTTP 代碼，並包含如下所示的回應：

{
  "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，但已取消的查詢現在會傳回 200 HTTP 碼，並包含如下回應：

{
  "head" : {
    "vars" : [ "s", "p", "o" ]
  },
  "results" : {
    "bindings" : [ ]
  }
}