API del estado de la consulta de Gremlin

Para obtener el estado de las consultas Gremlin, utilice HTTP GET o POST para realizar una solicitud al punto de enlace https://your-neptune-endpoint:port/gremlin/status.

Parámetros de solicitud de estado de consulta de Gremlin

• queryID (opcional): el identificador de una consulta de Gremlin en ejecución. Solo muestra el estado de la consulta especificada.

• includeWaiting (opcional): devuelve el estado de todas las consultas en espera.

  Normalmente, en la respuesta solo se incluyen las consultas en ejecución, pero cuando se especifica el parámetro includeWaiting, también se devuelve el estado de todas las consultas en espera.

Sintaxis de respuesta de estado de la consulta de Gremlin

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

Valores de respuesta de estado de la consulta de Gremlin

• 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 consultas de Gremlin que se están ejecutando actualmente.

• queries: una lista de las consultas de Gremlin actuales.

• queryId: un identificador GUID de la consulta. Neptune asigna automáticamente este valor de identificador a cada consulta o también puede asignar su propio identificador (consulte Inserte un identificador personalizado en una consulta de Neptune Gremlin o SPARQL).

• queryEvalStats— Estadísticas de esta consulta.

• subqueries: el número de subconsultas de esta consulta.

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

• cancelled: true indica que se canceló la consulta.

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

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

Ejemplo de estado de la consulta de Gremlin

A continuación se muestra un ejemplo de comando de estado que utiliza curl y HTTP GET.

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

Esta salida muestra una única consulta en ejecución.

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