API di stato delle query Gremlin

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

Parametri della richiesta di stato delle query Gremlin

• queryId (opzionale): ID di una query Gremlin in esecuzione. Viene mostrato solo lo stato della query specificata.

• includeWaiting (opzionale): restituisce lo stato di tutte le query in attesa.

  Normalmente, nella risposta sono incluse solo le query in esecuzione, ma quando viene specificato il parametro includeWaiting, viene restituito anche lo stato di tutte le query in attesa.

Sintassi della risposta di stato delle query Gremlin

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

Valori della risposta di stato delle query Gremlin

• accettate QueryCount: il numero di interrogazioni che sono state accettate ma non ancora completate, incluse le interrogazioni in coda.

• in esecuzione QueryCount: il numero di interrogazioni Gremlin attualmente in esecuzione.

• queries: elenco delle query Gremlin correnti.

• queryId: ID GUID della 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).

• query EvalStats — Statistiche per questa interrogazione.

• subqueries: numero di sottoquery in questa query.

• elapsed: numero di millisecondi in cui la query è stata eseguita finora.

• cancelled: il valore True indica che la query è stata annullata.

• queryString: la query inviata. Questa è troncata a 1024 caratteri nel caso in cui sia più lunga.

• waited: indica il tempo di attesa della query, in millisecondi.

Esempio di stato di una query Gremlin

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

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

Questo output mostra una sola query in esecuzione.

{
  "acceptedQueryCount":9,
  "runningQueryCount":1,
  "queries": [
    {
      "queryId":"fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
      "queryEvalStats":
        {
          "waited": 0,
          "elapsed": 23,
          "cancelled": false
        },
      "queryString": "g.V().out().count()"
    }
  ]
}