Servlet di stato ed endpoint di stato openCypher di Neptune

Parametri delle query di stato

• includeWaiting (true o false): se impostato su true e non sono presenti altri parametri, vengono restituite le informazioni sullo stato per le query in attesa e per quelle in esecuzione.

• cancelQuery: utilizzato solo con i metodi GET e POST, per indicare che si tratta di una richiesta di annullamento. Il metodo DELETE non richiede questo parametro.

  Il valore del parametro cancelQuery non viene utilizzato, ma quando cancelQuery è presente, è necessario il parametro queryId per identificare la query da annullare.

• queryId: contiene l'ID di una query specifica.

  Se utilizzato con il metodo GET o POST e il parametro cancelQuery non è presente, queryId restituisce informazioni sullo stato per la query specifica che identifica. Se il parametro cancelQuery è presente, la query specifica identificata da queryId viene annullata.

  Se utilizzato con il metodo DELETE, queryId indica sempre una query specifica da annullare.

• silent: utilizzato solo quando si annulla una query. Se impostato su true, l'annullamento avviene senza alcun avviso.

Campi di risposta di stato se non viene fornito l'ID di una query specifica

• acceptedQueryCount— Il numero di interrogazioni che sono state accettate ma non ancora completate, incluse le interrogazioni in coda.

• runningQueryCount— Il numero di query OpenCypher attualmente in esecuzione.

• queries: elenco delle query openCypher correnti.

Campi di risposta di stato per una query specifica

• 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).

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

• queryEvalStats— Statistiche per questa interrogazione:

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

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

  • cancelled: True indica che la query è stata annullata, False che non è stata annullata.

• Richiesta dello stato di tutte le query, comprese quelle in attesa:

  curl https://server:port/openCypher/status \
    --data-urlencode "includeWaiting=true"

  Risposta:

  {
    "acceptedQueryCount" : 0,
    "runningQueryCount" : 0,
    "queries" : [ ]
  }

• Richiesta dello stato delle query in esecuzione, escluse quelle in attesa:

  curl https://server:port/openCypher/status

  Risposta:

  {
    "acceptedQueryCount" : 0,
    "runningQueryCount" : 0,
    "queries" : [ ]
  }

• Richiesta dello stato di una singola query:

  curl https://server:port/openCypher/status \
   --data-urlencode "queryId=eadc6eea-698b-4a2f-8554-5270ab17ebee"

  Risposta:

  {
    "queryId" : "eadc6eea-698b-4a2f-8554-5270ab17ebee",
    "queryString" : "MATCH (n1)-[:knows]->(n2), (n2)-[:knows]->(n3), (n3)-[:knows]->(n4), (n4)-[:knows]->(n5), (n5)-[:knows]->(n6), (n6)-[:knows]->(n7), (n7)-[:knows]->(n8), (n8)-[:knows]->(n9), (n9)-[:knows]->(n10) RETURN COUNT(n1);",
    "queryEvalStats" : {
      "waited" : 0,
      "elapsed" : 23463,
      "cancelled" : false
    }
  }

• Richieste di annullamento di una query

  1. Con POST:

  curl -X POST https://server:port/openCypher/status \
    --data-urlencode "cancelQuery" \
    --data-urlencode "queryId=f43ce17b-db01-4d37-a074-c76d1c26d7a9"

  Risposta:

  {
    "status" : "200 OK",
    "payload" : true
  }

  2. Con GET:

  curl -X GET https://server:port/openCypher/status \
    --data-urlencode "cancelQuery" \
    --data-urlencode "queryId=588af350-cfde-4222-bee6-b9cedc87180d"

  Risposta:

  {
    "status" : "200 OK",
    "payload" : true
  }

  3. Con DELETE:

  curl -X DELETE \
    -s "https://server:port/openCypher/status?queryId=b9a516d1-d25c-4301-bb80-10b2743ecf0e"

  Risposta:

  {
    "status" : "200 OK",
    "payload" : true
  }