View a markdown version of this page

API di stato delle query Gremlin - Amazon Neptune
Interrogazioni sull'elencoStato di una singola interrogazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

API di stato delle query Gremlin

È possibile elencare tutte le interrogazioni Gremlin attive o ottenere lo stato di una query specifica. L'endpoint HTTP sottostante per entrambe le operazioni è. https://your-neptune-endpoint:port/gremlin/status

Elenco delle interrogazioni Gremlin attive

Per elencare tutte le query Gremlin attive, chiamate l'endpoint senza parametri. queryId

Parametri della richiesta

  • IncludeWaiting (opzionale): se impostato suTRUE, la risposta include le query in attesa oltre alle query in esecuzione.

Sintassi della risposta

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

  • acceptedQueryCount— Il numero di interrogazioni che sono state accettate ma non ancora completate, incluse le interrogazioni in coda.

  • runningQueryCount— Il numero di interrogazioni Gremlin attualmente in esecuzione.

  • queries: elenco delle query Gremlin correnti.

Esempio

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

Per ulteriori informazioni, vedere list-gremlin-queriesnel Command Reference. AWS CLI

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)

Per esempi AWS SDK in altri linguaggi come Java, .NET e altri, consultaAWS SDK.

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

Questo esempio presuppone che le tue AWS credenziali siano configurate nel tuo ambiente. Sostituisci us-east-1 con la regione del tuo cluster Neptune.

Per ulteriori informazioni sull'utilizzo awscurl con l'autenticazione IAM, consulta. Utilizzo di awscurl con credenziali temporanee per connettersi in modo sicuro a un cluster database con autenticazione IAM abilitata

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

L'output seguente mostra una singola query in esecuzione.

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

Ottenere lo stato di una specifica query Gremlin

Per ottenere lo stato di una specifica interrogazione Gremlin, fornite il queryId parametro.

Parametri della richiesta

Sintassi della risposta

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

  • queryID — L'ID della query.

  • queryString: la query inviata. Questa è troncata a 1024 caratteri nel caso in cui sia più lunga.

  • queryEvalStats— Statistiche per la query, tra cui waited (tempo di attesa in millisecondi), elapsed (tempo di esecuzione in millisecondi), cancelled (se la query è stata annullata) e (numero di sottoquery). subqueries

Esempio

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

Per ulteriori informazioni, vedere nel Command Reference. get-gremlin-query-status AWS CLI

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)

Per esempi AWS SDK in altri linguaggi come Java, .NET e altri, consultaAWS SDK.

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

Questo esempio presuppone che le tue AWS credenziali siano configurate nel tuo ambiente. Sostituisci us-east-1 con la regione del tuo cluster Neptune.

Per ulteriori informazioni sull'utilizzo awscurl con l'autenticazione IAM, consulta. Utilizzo di awscurl con credenziali temporanee per connettersi in modo sicuro a un cluster database con autenticazione IAM abilitata

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

Di seguito è riportata una risposta di esempio.

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