Annulation de requêtes SPARQL

Pour obtenir le statut des requêtes SPARQL, envoyez une demande HTTP GET ou POST pour effectuer une requête au point de terminaison https://your-neptune-endpoint:port/sparql/status.

Paramètres des demandes d'annulation des requêtes SPARQL

cancelQuery

(Obligatoire) Indique à la commande d'état d'annuler une requête. Ce paramètre n'est pas défini sur une valeur.

queryId

(Obligatoire) ID de la requête SPARQL en cours d'exécution à annuler.

silent

(Facultatif) Si silent=true, la requête en cours d'exécution est annulée et le code de réponse HTTP est 200. Si silent n'est pas présent ou si silent=false, la requête est annulée avec un code d'état HTTP 500.

Exemple d'annulation de requêtes SPARQL

Exemple 1 : Annulation avec silent=false

Voici un exemple de commande d'état utilisant curl pour annuler une requête avec le paramètre silent défini sur false :

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

Sauf si la requête a déjà commencé à diffuser des résultats, la requête annulée renvoie alors un code HTTP 500 avec une réponse comme celle-ci :

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

Si la requête a déjà renvoyé un code HTTP 200 (OK) et a commencé à diffuser des résultats avant d'être annulée, les informations d'exception de délai d'attente sont envoyées au flux de sortie normal.

Exemple 2 : Annulation avec silent=true

Voici un exemple de la même commande d'état que ci-dessus, mais avec le paramètre silent défini sur true :

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

Cette commande renvoie la même réponse que lorsque silent=false, mais la requête annulée renvoie désormais un code HTTP 200 avec une réponse similaire à celle-ci :

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