SPARQLAbbruch der Abfrage

Um den Status von SPARQL Abfragen abzurufen, verwenden Sie HTTP GET oder, POST um eine Anfrage an den https://your-neptune-endpoint:port/sparql/status Endpunkt zu stellen.

SPARQLParameter für Stornierungsanforderungen abfragen

cancelQuery

(Erforderlich) Weist den Statusbefehl an, eine Abfrage abzubrechen. Dieser Parameter akzeptiert keinen Wert.

queryId

(Erforderlich) Die ID der laufenden SPARQL Abfrage, die abgebrochen werden soll.

Still

(Optional) In diesem Fall silent=true wird die laufende Abfrage abgebrochen und der HTTP Antwortcode lautet 200. Wenn silent nicht vorhanden odersilent=false, wird die Abfrage mit einem Statuscode HTTP 500 abgebrochen.

SPARQLBeispiele für den Abbruch von Abfragen

Beispiel 1: Abbruch mit silent=false

Es folgt ein Beispiel für den Statusbefehl, der curl verwendet, um eine Abfrage abzubrechen, wobei der silent-Parameter auf false gesetzt ist:

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

Sofern die Abfrage nicht bereits mit dem Streamen von Ergebnissen begonnen hat, würde die abgebrochene Abfrage dann einen HTTP 500-Code mit einer Antwort wie der folgenden zurückgeben:

{
  "code": "CancelledByUserException",
  "requestId": "4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47",
  "detailedMessage": "Operation terminated (cancelled by user)"
}

Wenn die Abfrage bereits einen HTTP 200-Code (OK) zurückgegeben hat und vor dem Abbruch mit dem Streamen von Ergebnissen begonnen hat, werden die Ausnahmeinformationen zum Timeout an den regulären Ausgabestrom gesendet.

Beispiel 2: Abbruch mit silent=true

Nachfolgend finden Sie ein Beispiel für denselben Statusbefehl wie oben mit Ausnahme des silent-Parameters, der jetzt auf true gesetzt ist:

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

Dieser Befehl würde dieselbe Antwort wie bei wann zurückgebensilent=false, aber die abgebrochene Abfrage würde jetzt einen HTTP 200-Code mit einer Antwort wie dieser zurückgeben:

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