API di stato delle query SPARQL

Per ottenere lo stato delle query SPARQL, utilizza l'operazione HTTP GET o POST per effettuare una richiesta all'endpoint https://your-neptune-endpoint:port/sparql/status.

Parametri della richiesta di stato della query SPARQL

queryId (opzionale)

L'ID di una query SPARQL in esecuzione. Viene mostrato solo lo stato della query specificata.

Sintassi della risposta di stato della query SPARQL

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

Valori della risposta di stato della query SPARQL

accettato QueryCount

Numero di query accettate dall'ultimo riavvio del motore Neptune.

correndo QueryCount

Il numero delle query SPARQL in esecuzione.

queries

Un elenco delle query SPARQL correnti.

queryId

Un ID GUID per la query. Neptune assegna automaticamente questo valore ID a ogni query oppure è possibile assegnare un ID personalizzato (consulta Inserimento di un ID personalizzato in una query Neptune Gremlin o SPARQL).

interrogazione EvalStats

Le statistiche relative a questa query.

subqueries

Numero di sottoquery in questa query.

elapsed

Il numero di millisecondi durante i quali è stata eseguita la query (fino a questo momento).

cancelled

Il valore True indica che la query è stata annullata.

queryString

La query inviata.

Esempio di stato della query SPARQL

Di seguito è riportato un esempio del comando di stato che utilizza curl e l'operazione HTTP GET.

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

Questo output mostra una sola query in esecuzione.

{
    "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}"
        }
    ]
}