View a markdown version of this page

API del estado de la consulta de Gremlin - Amazon Neptune

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

API del estado de la consulta de Gremlin

Puedes enumerar todas las consultas de Gremlin activas u obtener el estado de una consulta específica. El punto final HTTP subyacente para ambas operaciones es https://your-neptune-endpoint:port/gremlin/status.

Listar las consultas activas de Gremlin

Para enumerar todas las consultas de Gremlin activas, llama al punto final sin queryId parámetro.

Parámetros de solicitud

  • Incluir en espera (opcional) — Si se establece en TRUE, la respuesta incluye las consultas en espera además de las consultas en ejecución.

Sintaxis de la respuesta

{ "acceptedQueryCount": integer, "runningQueryCount": integer, "queries": [ { "queryId": "guid", "queryEvalStats": { "waited": integer, "elapsed": integer, "cancelled": boolean }, "queryString": "string" } ] }
  • aceptadaQueryCount — El número de consultas que se han aceptado pero que aún no se han completado, incluidas las consultas en cola.

  • corriendoQueryCount — El número de consultas de Gremlin que se están ejecutando actualmente.

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

Ejemplo

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

Para obtener más información, consulte list-gremlin-queries en el AWS CLI Referencia de comandos.

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)

Para AWS Ejemplos de SDK en otros lenguajes como Java, .NET y más, consulta AWS SDK.

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

Este ejemplo asume que tu AWS las credenciales están configuradas en su entorno. Reemplazar us-east-1 con la región de su cúmulo de Neptuno.

Para obtener más información sobre el uso awscurl con la autenticación de IAM, consulte Usando como curl con credenciales temporales para conectarse de forma segura a un clúster de base de datos con la autenticación de IAM habilitada.

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

El siguiente resultado 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()" } ] }

Obtener el estado de una consulta de Gremlin específica

Para obtener el estado de una consulta de Gremlin específica, proporciona queryId parámetro.

Parámetros de solicitud

Sintaxis de la respuesta

{ "queryId": "guid", "queryString": "string", "queryEvalStats": { "waited": integer, "elapsed": integer, "cancelled": boolean, "subqueries": document } }
  • ID de consulta — El identificador de la consulta.

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

  • consultaEvalStats — Estadísticas de la consulta, incluidas waited (tiempo de espera en milisegundos), elapsed (tiempo de ejecución en milisegundos), cancelled (si la consulta se canceló) y subqueries (el número de subconsultas).

Ejemplo

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

Para obtener más información, consulte get-gremlin-query-status en el AWS CLI Referencia de comandos.

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)

Para AWS Ejemplos de SDK en otros lenguajes como Java, .NET y más, consulta AWS SDK.

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

Este ejemplo asume que tu AWS las credenciales están configuradas en su entorno. Reemplazar us-east-1 con la región de su cúmulo de Neptuno.

Para obtener más información sobre el uso awscurl con la autenticación de IAM, consulte Usando como curl con credenciales temporales para conectarse de forma segura a un clúster de base de datos con la autenticación de IAM habilitada.

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

A continuación, se muestra un ejemplo de respuesta.

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