API de statut des 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 de statut des requêtes SPARQL

queryId (facultatif)

ID d'une requête SPARQL en cours d'exécution. Affiche uniquement le statut de la requête indiquée.

Syntaxe des réponses de statut des requêtes SPARQL

{
    "acceptedQueryCount": integer,
    "runningQueryCount": integer,
    "queries": [
      {
        "queryId":"guid",
        "queryEvalStats":
          {
            "subqueries": integer,
            "elapsed": integer,
            "cancelled": boolean
          },
        "queryString": "string"
      }
    ]
}

Valeurs des réponses de statut des requêtes SPARQL

acceptedQueryCount

Nombre de requêtes acceptées depuis le dernier redémarrage du moteur Neptune.

runningQueryCount

Nombre de requêtes SPARQL en cours d'exécution.

queries

Liste des requêtes SPARQL actuelles.

queryId

GUID de la requête. Neptune attribue automatiquement cette valeur d'ID à chaque requête, mais vous pouvez également attribuer votre propre ID (voir Injection d'un ID personnalisé dans une requête Neptune Gremlin ou SPARQL).

queryEvalStats

Statistiques pour cette requête.

subqueries

Nombre de sous-requêtes de cette requête.

elapsed

Nombre de microsecondes d'exécution de la requête jusqu'ici.

cancelled

True indique que la requête a été annulée.

queryString

Requête soumise.

Exemple de statut des requêtes SPARQL

Voici un exemple de commande de demande du statut utilisant curl et la demande HTTP GET.

curl https://your-neptune-endpoint:port/sparql/status

Cette sortie affiche une seule requête en cours d'exécution.

{
    "acceptedQueryCount":9,
    "runningQueryCount":1,
    "queries": [
        {
            "queryId":"fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
            "queryEvalStats":
                {
                    "subqueries": 0,
                    "elapsed": 29256,
                    "cancelled": false
                },
            "queryString": "SELECT ?s ?p ?o WHERE {?s ?p ?o}"
        }
    ]
}