View a markdown version of this page

API de statut des requêtes Gremlin - Amazon Neptune
Requêtes sur les listesÉtat de la requête unique

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

API de statut des requêtes Gremlin

Vous pouvez répertorier toutes les requêtes Gremlin actives ou obtenir le statut d'une requête spécifique. Le point de terminaison HTTP sous-jacent pour les deux opérations esthttps://your-neptune-endpoint:port/gremlin/status.

Liste des requêtes Gremlin actives

Pour répertorier toutes les requêtes Gremlin actives, appelez le point de terminaison sans aucun queryId paramètre.

Paramètres de demande

  • IncludeWaiting (facultatif) — Si ce paramètre est défini surTRUE, la réponse inclut les requêtes en attente en plus des requêtes en cours d'exécution.

Syntaxe de réponse

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

  • acceptée QueryCount  : nombre de requêtes qui ont été acceptées mais qui ne sont pas encore terminées, y compris les requêtes dans la file d'attente.

  • running QueryCount — Le nombre de requêtes Gremlin en cours d'exécution.

  • queries : requêtes Gremlin actuelles.

Exemple

AWS CLI
aws neptunedata list-gremlin-queries \
  --endpoint-url https://your-neptune-endpoint:port

Pour plus d'informations, consultez https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html list-gremlin-queries dans la référence des commandes. AWS CLI

SDK
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.list_gremlin_queries()

print(response)

Pour des exemples de AWS SDK dans d'autres langages tels que Java, .NET, etc., consultezAWS SDK.

awscurl
awscurl https://your-neptune-endpoint:port/gremlin/status \
  --region us-east-1 \
  --service neptune-db
Note

Cet exemple suppose que vos AWS informations d'identification sont configurées dans votre environnement. us-east-1Remplacez-la par la région de votre amas Neptune.

Pour plus d'informations sur l'utilisation awscurl de l'authentification IAM, consultezUtilisation de awscurl avec des informations d'identification temporaires pour se connecter en toute sécurité à un cluster de bases de données avec l'authentification IAM activée.

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

La sortie suivante montre 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()"
    }
  ]
}

Obtenir le statut d'une requête Gremlin spécifique

Pour obtenir l'état d'une requête Gremlin spécifique, indiquez le queryId paramètre.

Paramètres de demande

Syntaxe de réponse

{
  "queryId": "guid",
  "queryString": "string",
  "queryEvalStats": {
    "waited": integer,
    "elapsed": integer,
    "cancelled": boolean,
    "subqueries": document
  }
}

  • QueryID — L'ID de la requête.

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

  • query EvalStats  : statistiques relatives à la requête, notamment waited (temps d'attente en millisecondes), elapsed (durée d'exécution en millisecondes), cancelled (si la requête a été annulée) et subqueries (nombre de sous-requêtes).

Exemple

AWS CLI
aws neptunedata get-gremlin-query-status \
  --endpoint-url https://your-neptune-endpoint:port \
  --query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"

Pour plus d'informations, consultez get-gremlin-query-status dans la référence des commandes. AWS CLI

SDK
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.get_gremlin_query_status(
    queryId='fb34cd3e-f37c-4d12-9cf2-03bb741bf54f'
)

print(response)

Pour des exemples de AWS SDK dans d'autres langages tels que Java, .NET, etc., consultezAWS SDK.

awscurl
awscurl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f \
  --region us-east-1 \
  --service neptune-db
Note

Cet exemple suppose que vos AWS informations d'identification sont configurées dans votre environnement. us-east-1Remplacez-la par la région de votre amas Neptune.

Pour plus d'informations sur l'utilisation awscurl de l'authentification IAM, consultezUtilisation de awscurl avec des informations d'identification temporaires pour se connecter en toute sécurité à un cluster de bases de données avec l'authentification IAM activée.

curl
curl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f

Voici un exemple de réponse.

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