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 su`TRUE`, 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-queries](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html)nel 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, consulta[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ 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](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)
------
#### [ 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
+ **queryId** *(*obbligatorio) — L'ID della query Gremlin. Neptune assegna automaticamente questo valore ID a ogni query, oppure puoi assegnare il tuo ID (vedi). [Inserimento di un ID personalizzato in una query Neptune Gremlin o SPARQL](features-query-id.md)
### 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](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-gremlin-query-status.html) 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, consulta[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ 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](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)
------
#### [ 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
}
}
```