

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# SPARQL-Abfrageabbruch
<a name="sparql-api-status-cancel"></a>

Zum Abrufen des Status von SPARQL-Abfragen verwenden Sie HTTP `GET` oder `POST`, um eine Anforderung an den `https://your-neptune-endpoint:port/sparql/status`-Endpunkt zu senden.

## SPARQL-Abfrageabruch-Anforderungsparameter
<a name="sparql-api-status-cancel-request"></a>

**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) Bei `silent=true` wird die laufende Abfrage abgebrochen, und der HTTP-Antwortcode lautet 200. Wenn `silent` nicht vorhanden ist oder bei `silent=false` wird die Abfrage mit einem HTTP 500-Statuscode abgebrochen.

## SPARQL-Abfrageabbruch-Beispiele
<a name="sparql-api-status-cancel-example"></a>

**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"
```

Wenn die Abfrage nicht bereits mit dem Streaming der Ergebnisse begonnen hat, würde die abgebrochene Abfrage dann einen HTTP-500-Code mit einer Antwort wie folgt 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 mit dem Streaming der Ergebnisse begonnen hat, bevor sie abgebrochen wurde, werden die Informationen zur Zeitbeschränkungsausnahme an den regulären Ausgabe-Stream 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 die gleiche Antwort wie bei `silent=false` zurückgeben, aber die abgebrochene Abfrage würde jetzt einen HTTP 200-Code mit einer Antwort wie folgt zurückgeben:

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