View a markdown version of this page

API de statut des requêtes Gremlin - Amazon Neptune
Demandes d'inscriptionÉ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.

Répertorier les 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

  • IncludeWaiting (facultatif) — Si cette valeur est définie 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"
    }
  ]
}

  • 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 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 list-gremlin-queriesle manuel de référence des AWS CLI commandes.

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. Remplacez us-east-1 par la région de votre cluster Neptune.

Pour plus d'informations sur l'utilisation awscurl de l'authentification IAM, consultezUtilisation d'informations d'identification temporaires awscurl 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

Le résultat suivant 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, 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.

  • queryEvalStats— Statistiques relatives à la requête, notamment waited (temps d'attente en millisecondes), elapsed (temps 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-statusle manuel de référence des AWS CLI commandes.

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. Remplacez us-east-1 par la région de votre cluster Neptune.

Pour plus d'informations sur l'utilisation awscurl de l'authentification IAM, consultezUtilisation d'informations d'identification temporaires awscurl 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
  }
}