View a markdown version of this page

API del estado de la consulta de Gremlin - Amazon Neptune
Listado de consultasEstado de consulta única

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 de Gremlin activas

Para ver una lista de todas las consultas de Gremlin activas, llama al punto final sin ningún queryId parámetro.

Parámetros de solicitud

  • includeWaiting (opcional): si se establece enTRUE, 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"
    }
  ]
}

  • acceptedQueryCount— El número de consultas que se han aceptado pero que aún no se han completado, incluidas las consultas de la cola.

  • runningQueryCount— 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 la list-gremlin-queriesReferencia de AWS CLI 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 ver ejemplos de AWS SDK en otros lenguajes, como Java, .NET y más, consulteAWS SDK.

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

En este ejemplo se supone que sus AWS credenciales están configuradas en su entorno. us-east-1Sustitúyala por la región de tu cúmulo de Neptuno.

Para obtener más información sobre el uso awscurl con la autenticación de IAM, consulte. Uso de awscurl 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 el queryId parámetro.

Parámetros de solicitud

Sintaxis de la respuesta

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

  • queryID: el ID de la consulta.

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

  • queryEvalStats— Estadísticas de la consulta, que incluyen waited (tiempo de espera en milisegundos), elapsed (tiempo de ejecución en milisegundos), cancelled (si la consulta se canceló) y subqueries (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-statusla Referencia de AWS CLI 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 ver ejemplos de AWS SDK en otros lenguajes, como Java, .NET y más, consulteAWS SDK.

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

En este ejemplo se supone que sus AWS credenciales están configuradas en su entorno. us-east-1Sustitúyala por la región de tu cúmulo de Neptuno.

Para obtener más información sobre el uso awscurl con la autenticación de IAM, consulte. Uso de awscurl 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
  }
}