Neptune-openCypher-Status-Servlet und Statusendpunkt

Statusabfrage-Parameter

• includeWaiting (true oder false)   –   Wenn auf true festgelegt und keine anderen Parameter vorhanden sind, werden Statusinformationen für wartende und ausgeführte Abfragen zurückgegeben.

• cancelQuery   –   Wird nur mit den Methoden POST und GET verwendet, um anzuzeigen, dass es sich um eine Abbruchanforderung handelt. Die Methode DELETE benötigt diesen Parameter nicht.

  Der Wert des Parameters cancelQuery wird nicht verwendet. Wenn jedoch cancelQuery vorhanden ist, ist der Parameter queryId erforderlich, um die Abfrage zu identifizieren, die abgebrochen werden soll.

• queryId   –   Enthält die ID einer bestimmten Abfrage.

  Wenn mit den Methoden GET oder POST verwendet und wenn der Parameter cancelQuery nicht vorhanden ist, veranlasst queryId die Rückgabe von Statusinformationen für die spezifische identifizierte Abfrage. Wenn der Parameter cancelQuery vorhanden ist, wird die spezifische Abfrage abgebrochen, die queryId identifiziert.

  Gibt bei Verwendung mit der Methode DELETE gibt queryId stets eine bestimmte Abfrage an, die abgebrochen werden soll.

• silent   –   Wird nur beim Abbruch einer Abfrage verwendet. Wenn auf true festgelegt, erfolgt der Abbruch im Hintergrund.

Statusantwortfelder, wenn die ID einer bestimmten Abfrage nicht angegeben wird

• acceptedQueryCount— Die Anzahl der Abfragen, die akzeptiert, aber noch nicht abgeschlossen wurden, einschließlich Abfragen in der Warteschlange.

• runningQueryCount— Die Anzahl der aktuell laufenden OpenCypher-Abfragen.

• queries   –   Eine Liste der aktuellen openCypher-Abfragen.

Statusantwortfelder für eine bestimmte Abfrage

• queryId   –   Eine GUID-ID für die Abfrage. Neptune weist diesen ID-Wert automatisch jeder Abfrage zu. Sie können auch eine eigene ID zuweisen (siehe Einfügen einer benutzerdefinierten ID in eine Neptune-Gremlin- oder -SPARQL-Abfrage).

• queryString   –   Die übermittelte Abfrage. Die Abfrage wird nach 1024 Zeichen abgeschnitten, wenn sie länger ist.

• queryEvalStats— Statistiken für diese Abfrage:

  • waited   –   Der Zeitraum in Millisekunden, über den die Abfrage gewartet hat.

  • elapsed   –   Der Zeitraum in Millisekunden, über den die Abfrage bis jetzt ausgeführt wurde.

  • cancelled   –   True gibt an, dass die Abfrage abgebrochen wurde; False gibt an, dass sie nicht abgebrochen wurde.

• Anforderung des Status aller Abfragen, einschließlich wartender Abfragen:

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

  Antwort:

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

• Anforderung des Status ausgeführter Abfragen, ohne wartende Abfragen:

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

  Antwort:

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

• Anforderung des Status einer einzelnen Abfrage:

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

  Antwort:

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

• Anforderungen des Abbruchs einer Abfrage

  1. Verwenden von POST:

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

  Antwort:

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

  2. Verwenden von GET:

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

  Antwort:

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

  3. Verwenden von DELETE:

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

  Antwort:

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