API de statut des requêtes Gremlin

Pour obtenir le statut des requêtes Gremlin, utilisez HTTP GET ou POST pour effectuer une requête au point de terminaison https://your-neptune-endpoint:port/gremlin/status.

Paramètres des demandes de statut des requêtes Gremlin

• queryID (facultatif) : ID d'une requête Gremlin en cours d'exécution. Affiche uniquement le statut de la requête indiquée.

• includeWaiting (facultatif) : renvoie le statut de toutes les requêtes en attente.

  Normalement, seules les requêtes en cours sont incluses dans la réponse, mais lorsque le paramètre includeWaiting est spécifié, le statut de toutes les requêtes en attente est également renvoyé.

Syntaxe des réponses de statut des requêtes Gremlin

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

Valeurs des réponses de statut des requêtes Gremlin

• acceptedQueryCount— Le nombre de requêtes acceptées mais non encore terminées, y compris les requêtes dans la file d'attente.

• runningQueryCount— Le nombre de requêtes Gkremlin en cours d'exécution.

• queries : requêtes Gremlin actuelles.

• queryID : identifiant GUID de la requête. Neptune attribue automatiquement cette valeur d'ID à chaque requête, mais vous pouvez également attribuer votre propre ID (voir Injection d'un ID personnalisé dans une requête Neptune Gremlin ou SPARQL).

• queryEvalStats— Statistiques pour cette requête.

• subqueries : nombre de sous-requêtes de cette requête.

• elapsed : nombre de microsecondes d'exécution de la requête jusqu'au moment T.

• cancelled : true indique que la requête a été annulée.

• queryString : requête soumise. Celle-ci est tronquée à 1 024 caractères si elle est plus longue que cela.

• waited : indique la durée d'attente de la requête, en millisecondes.

Exemple de statut de requête Gremlin

Voici un exemple de commande de demande du statut utilisant curl et la demande HTTP GET.

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

Cette sortie affiche une seule requête en cours d'exécution.

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