View a markdown version of this page

API de status de consulta do Gremlin - Amazon Neptune
Listando consultasStatus de consulta única

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

API de status de consulta do Gremlin

Você pode listar todas as consultas ativas do Gremlin ou obter o status de uma consulta específica. O endpoint HTTP subjacente para ambas as operações éhttps://your-neptune-endpoint:port/gremlin/status.

Listando consultas ativas do Gremlin

Para listar todas as consultas ativas do Gremlin, chame o endpoint sem nenhum parâmetro. queryId

Parâmetros de solicitação

  • IncludeWaiting (opcional) — Se definida comoTRUE, a resposta inclui consultas em espera, além de consultas em execução.

Sintaxe da resposta

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

  • acceptedQueryCount— O número de consultas que foram aceitas, mas ainda não concluídas, incluindo consultas na fila.

  • runningQueryCount— O número de consultas do Gremlin atualmente em execução.

  • queries: uma lista de consultas do Gremlin atuais.

Exemplo

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

Para obter mais informações, consulte list-gremlin-queriesna Referência 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 exemplos de AWS SDK em outras linguagens, como Java, .NET e muito mais, consulteAWS SDK.

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

Este exemplo pressupõe que suas AWS credenciais estejam configuradas em seu ambiente. us-east-1Substitua pela região do seu cluster Neptune.

Para obter mais informações sobre como usar awscurl com a autenticação do IAM, consulteUsar awscurl com credenciais temporárias para se conectar com segurança a um cluster de banco de dados com a autenticação do IAM habilitada.

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

A saída a seguir mostra uma única consulta em execução.

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

Obter o status de uma consulta específica do Gremlin

Para obter o status de uma consulta específica do Gremlin, forneça o queryId parâmetro.

Parâmetros de solicitação

Sintaxe da resposta

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

  • queryID — O ID da consulta.

  • queryString: a consulta enviada. Ela será truncada para 1024 caracteres se for maior do que isso.

  • queryEvalStats— Estatísticas da consulta, incluindo waited (tempo de espera em milissegundos), elapsed (tempo de execução em milissegundos), cancelled (se a consulta foi cancelada) e subqueries (o número de subconsultas).

Exemplo

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

Para obter mais informações, consulte get-gremlin-query-statusna Referência 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 exemplos de AWS SDK em outras linguagens, como Java, .NET e muito mais, consulteAWS SDK.

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

Este exemplo pressupõe que suas AWS credenciais estejam configuradas em seu ambiente. us-east-1Substitua pela região do seu cluster Neptune.

Para obter mais informações sobre como usar awscurl com a autenticação do IAM, consulteUsar awscurl com credenciais temporárias para se conectar com segurança a um cluster de banco de dados com a autenticação do IAM habilitada.

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

O seguinte é um exemplo de resposta.

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