Servlet de openCypher estado de Neptune y punto final de estado

Parámetros de la consulta de estado

• includeWaiting (true o false): cuando se establece en true y otros parámetros no están presentes, se devuelve la información de estado tanto para las consultas en espera como para las consultas en ejecución.

• cancelQuery: se utiliza únicamente con los métodos GET y POST para indicar que se trata de una solicitud de cancelación. El método DELETE no necesita este parámetro.

  El valor del parámetro cancelQuery no se utiliza, pero cuando cancelQuery está presente, el parámetro queryId es obligatorio para identificar qué consulta se va a cancelar.

• queryId: contiene el identificador de una consulta específica.

  Cuando se usa con el método GET o POST y el parámetro cancelQuery no está presente, queryId hace que se devuelva la información de estado de la consulta específica que identifica. Si el parámetro cancelQuery está presente, se cancela la consulta específica que queryId identifica.

  Cuando se usa con el método DELETE, queryId siempre indica que se debe cancelar una consulta específica.

• silent: solo se usa al cancelar una consulta. Si se establece en true, hace que la cancelación se produzca de forma silenciosa.

Campos de respuesta de estado si no se proporciona el identificador de una consulta específica

• acceptedQueryCount— El número de consultas que se han aceptado pero que aún no se han completado, incluidas las consultas de la cola.

• runningQueryCount— El número de openCypher consultas que se están ejecutando actualmente.

• consultas: lista de las openCypher consultas actuales.

Campos de respuesta de estado para una consulta específica

• queryId— Un GUID identificador para la consulta. Neptune asigna automáticamente este valor de identificador a cada consulta o también puede asignar su propio identificador (consulte Inyectar un ID personalizado en un gremlin o consulta de Neptune SPARQL).

• queryString— La consulta enviada. Esta se trunca en 1024 caracteres, si supera este número.

• queryEvalStats— Estadísticas de esta consulta:

  • waited: indica cuánto tiempo esperó la consulta, en milisegundos.

  • elapsed: el número de milisegundos que la consulta lleva en ejecución.

  • cancelled: True indica que la consulta se ha cancelado o False que no se ha cancelado.

• Solicitud del estado de todas las consultas, incluidas las que están en espera:

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

  Respuesta:

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

• Solicitud del estado de todas las consultas, sin incluir las que están en espera:

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

  Respuesta:

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

• Solicitud del estado de una sola consulta:

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

  Respuesta:

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

• Solicitudes para cancelar una consulta

  1. Uso de POST:

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

  Respuesta:

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

  2. Uso de GET:

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

  Respuesta:

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

  3. Uso de DELETE:

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

  Respuesta:

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