View a markdown version of this page

API de statut des requêtes Gremlin - Amazon Neptune

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 est https://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 queryId paramètre.

Paramètres de demande

  • Inclure l'attente (optionnel) — S'il est réglé sur TRUE, la réponse inclut des 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éQueryCount — Le nombre de requêtes qui ont été acceptées mais pas encore terminées, y compris les requêtes dans la file d'attente.

  • courseQueryCount — 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, voir requêtes list-gremlin dans le AWS CLI Référence de commande.

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 AWS Exemples de SDK dans d'autres langages tels que Java, .NET, etc., voir AWS SDK.

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

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

Pour plus d'informations sur l'utilisation awscurl avec authentification IAM, voir En utilisant 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 le statut d'une requête Gremlin spécifique, fournissez 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 } }
  • ID de requête — 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.

  • requêteEvalStats — Statistiques relatives à la requête, y compris 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 (le 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, voir get-gremlin-query-status dans le AWS CLI Référence de commande.

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 AWS Exemples de SDK dans d'autres langages tels que Java, .NET, etc., voir AWS 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 votre AWS les informations d'identification sont configurées dans votre environnement. Remplacer us-east-1 avec la région de votre amas de Neptune.

Pour plus d'informations sur l'utilisation awscurl avec authentification IAM, voir En utilisant 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 } }