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à.
Servlet di stato ed endpoint di stato openCypher di Neptune
L'endpoint di stato openCypher fornisce l'accesso alle informazioni sulle query attualmente in esecuzione sul server o in attesa di essere eseguite. Consente inoltre di annullare tali query. L'endpoint è:
https://(the server):(the port number)/openCypher/status
È possibile utilizzare i metodi HTTP GET e POST per ottenere lo stato corrente dal server o per annullare una query. È inoltre possibile utilizzare il metodo DELETE per annullare una query in esecuzione o in attesa.
Parametri per le richieste di stato
Parametri delle query di stato
-
includeWaiting (true o false): se impostato su true e non sono presenti altri parametri, vengono restituite le informazioni sullo stato per le query in attesa e per quelle in esecuzione.
-
cancelQuery: utilizzato solo con i metodi GET e POST, per indicare che si tratta di una richiesta di annullamento. Il metodo DELETE non richiede questo parametro.
Il valore del parametro cancelQuery non viene utilizzato, ma quando cancelQuery è presente, è necessario il parametro queryId per identificare la query da annullare.
-
queryId: contiene l'ID di una query specifica.
Se utilizzato con il metodo GET o POST e il parametro cancelQuery non è presente, queryId restituisce informazioni sullo stato per la query specifica che identifica. Se il parametro cancelQuery è presente, la query specifica identificata da queryId viene annullata.
Se utilizzato con il metodo DELETE, queryId indica sempre una query specifica da annullare.
-
silent: utilizzato solo quando si annulla una query. Se impostato su true, l'annullamento avviene senza alcun avviso.
Campi di risposta della richiesta di stato
Campi di risposta di stato se non viene fornito l'ID di una query specifica
acceptedQueryCount— Il numero di interrogazioni che sono state accettate ma non ancora completate, incluse le interrogazioni in coda.
runningQueryCount— Il numero di query OpenCypher attualmente in esecuzione.
queries: elenco delle query openCypher correnti.
Campi di risposta di stato per una query specifica
queryId: ID GUID della query. Neptune assegna automaticamente questo valore ID a ogni query oppure è possibile assegnare un ID personalizzato (consulta Inserimento di un ID personalizzato in una query Neptune Gremlin o SPARQL).
queryString: la query inviata. Questa è troncata a 1024 caratteri nel caso in cui sia più lunga.
-
queryEvalStats— Statistiche per questa interrogazione:
waited: indica il tempo di attesa della query, in millisecondi.
elapsed: numero di millisecondi in cui la query è stata eseguita finora.
cancelled: True indica che la query è stata annullata, False che non è stata annullata.
Esempi di richieste e risposte di stato
-
Richiesta dello stato di tutte le query, comprese quelle in attesa:
- AWS CLI
-
aws neptunedata get-open-cypher-query-status \
--endpoint-url https://your-neptune-endpoint:port \
--include-waiting
Per ulteriori informazioni, vedere get-open-cypher-query-status nel AWS CLI Command Reference.
- 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_open_cypher_query_status(
includeWaiting=True
)
print(response)
Per esempi AWS SDK in altre lingue, consulta. AWS SDK
- awscurl
-
awscurl https://your-neptune-endpoint:port/openCypher/status \
--region us-east-1 \
--service neptune-db \
-X POST \
-d "includeWaiting=true"
Questo esempio presuppone che le AWS credenziali siano configurate nel proprio ambiente. Sostituisci us-east-1 con la regione del tuo cluster Neptune.
- curl
-
curl https://your-neptune-endpoint:port/openCypher/status \
--data-urlencode "includeWaiting=true"
Risposta:
{
"acceptedQueryCount" : 0,
"runningQueryCount" : 0,
"queries" : [ ]
}
-
Richiesta dello stato delle query in esecuzione, escluse quelle in attesa:
- AWS CLI
-
aws neptunedata get-open-cypher-query-status \
--endpoint-url https://your-neptune-endpoint:port
Per ulteriori informazioni, vedere get-open-cypher-query-status 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.get_open_cypher_query_status()
print(response)
Per esempi AWS SDK in altre lingue, consulta. AWS SDK
- awscurl
-
awscurl https://your-neptune-endpoint:port/openCypher/status \
--region us-east-1 \
--service neptune-db
Questo esempio presuppone che le AWS credenziali siano configurate nel proprio ambiente. Sostituisci us-east-1 con la regione del tuo cluster Neptune.
- curl
-
curl https://your-neptune-endpoint:port/openCypher/status
Risposta:
{
"acceptedQueryCount" : 0,
"runningQueryCount" : 0,
"queries" : [ ]
}
-
Richiesta dello stato di una singola query:
- AWS CLI
-
aws neptunedata get-open-cypher-query-status \
--endpoint-url https://your-neptune-endpoint:port \
--query-id eadc6eea-698b-4a2f-8554-5270ab17ebee
Per ulteriori informazioni, vedere get-open-cypher-query-status 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.get_open_cypher_query_status(
queryId='eadc6eea-698b-4a2f-8554-5270ab17ebee'
)
print(response)
Per esempi AWS SDK in altre lingue, consulta. AWS SDK
- awscurl
-
awscurl https://your-neptune-endpoint:port/openCypher/status \
--region us-east-1 \
--service neptune-db \
-X POST \
-d "queryId=eadc6eea-698b-4a2f-8554-5270ab17ebee"
Questo esempio presuppone che le AWS credenziali siano configurate nel proprio ambiente. Sostituisci us-east-1 con la regione del tuo cluster Neptune.
- curl
-
curl https://your-neptune-endpoint:port/openCypher/status \
--data-urlencode "queryId=eadc6eea-698b-4a2f-8554-5270ab17ebee"
Risposta:
{
"queryId" : "eadc6eea-698b-4a2f-8554-5270ab17ebee",
"queryString" : "MATCH (n1)-[:knows]->(n2), (n2)-[:knows]->(n3), (n3)-[:knows]->(n4), (n4)-[:knows]->(n5), (n5)-[:knows]->(n6), (n6)-[:knows]->(n7), (n7)-[:knows]->(n8), (n8)-[:knows]->(n9), (n9)-[:knows]->(n10) RETURN COUNT(n1);",
"queryEvalStats" : {
"waited" : 0,
"elapsed" : 23463,
"cancelled" : false
}
}
-
Richieste di annullamento di una query
- AWS CLI
-
aws neptunedata cancel-open-cypher-query \
--endpoint-url https://your-neptune-endpoint:port \
--query-id f43ce17b-db01-4d37-a074-c76d1c26d7a9
Per ulteriori informazioni, vedere cancel-open-cypher-querynel AWS CLI Command Reference.
- 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.cancel_open_cypher_query(
queryId='f43ce17b-db01-4d37-a074-c76d1c26d7a9'
)
print(response)
Per esempi AWS SDK in altre lingue, consultaAWS SDK.
- awscurl
-
awscurl https://your-neptune-endpoint:port/openCypher/status \
--region us-east-1 \
--service neptune-db \
-X POST \
-d "cancelQuery" \
-d "queryId=f43ce17b-db01-4d37-a074-c76d1c26d7a9"
Questo esempio presuppone che le AWS credenziali siano configurate nel proprio ambiente. Sostituisci us-east-1 con la regione del tuo cluster Neptune.
- curl
-
1. Con POST:
curl -X POST https://your-neptune-endpoint:port/openCypher/status \
--data-urlencode "cancelQuery" \
--data-urlencode "queryId=f43ce17b-db01-4d37-a074-c76d1c26d7a9"
2. Con GET:
curl -X GET https://your-neptune-endpoint:port/openCypher/status \
--data-urlencode "cancelQuery" \
--data-urlencode "queryId=588af350-cfde-4222-bee6-b9cedc87180d"
3. Con DELETE:
curl -X DELETE \
"https://your-neptune-endpoint:port/openCypher/status?queryId=b9a516d1-d25c-4301-bb80-10b2743ecf0e"
Risposta:
{
"status" : "200 OK",
"payload" : true
}
