Annulation de requêtes SPARQL

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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" : [ ]
  }
}