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à.

# Interrogazione su Neptune APIs
Esecuzione di query

**Azioni di query Gremlin:**
+ [ExecuteGremlinQuery (azione)](#ExecuteGremlinQuery)
+ [ExecuteGremlinExplainQuery (azione)](#ExecuteGremlinExplainQuery)
+ [ExecuteGremlinProfileQuery (azione)](#ExecuteGremlinProfileQuery)
+ [ListGremlinQueries (azione)](#ListGremlinQueries)
+ [GetGremlinQueryStatus (azione)](#GetGremlinQueryStatus)
+ [CancelGremlinQuery (azione)](#CancelGremlinQuery)

**Azioni di query openCypher:**
+ [ExecuteOpenCypherQuery (azione)](#ExecuteOpenCypherQuery)
+ [ExecuteOpenCypherExplainQuery (azione)](#ExecuteOpenCypherExplainQuery)
+ [ListOpenCypherQueries (azione)](#ListOpenCypherQueries)
+ [GetOpenCypherQueryStatus (azione)](#GetOpenCypherQueryStatus)
+ [CancelOpenCypherQuery (azione)](#CancelOpenCypherQuery)

**Strutture di query:**
+ [QueryEvalStats (struttura)](#QueryEvalStats)
+ [GremlinQueryStatus (struttura)](#GremlinQueryStatus)
+ [GremlinQueryStatusAttributes (struttura)](#GremlinQueryStatusAttributes)

## ExecuteGremlinQuery (azione)
ExecuteGremlinQuery

         Il nome AWS CLI per questa API è:. `execute-gremlin-query`

Questo comando esegue una query Gremlin. [Amazon Neptune è compatibile con TinkerPop Apache 3 e Gremlin, quindi puoi usare il linguaggio di attraversamento Gremlin per interrogare il grafico, come descritto in Il grafico nella documentazione di Apache 3.](https://tinkerpop.apache.org/docs/current/reference/#graph) TinkerPop Ulteriori dettagli sono disponibili anche in [Accesso a un grafo Neptune con Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-gremlin.html).

Quando si richiama questa operazione in un cluster Neptune in cui è abilitata l'autenticazione IAM, all'utente o al ruolo IAM che effettua la richiesta deve essere associata una policy che consenta una delle seguenti azioni IAM nel cluster, a seconda della query:
+ [neptune-db: ReadDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#readdataviaquery)
+ [nettuno-db: WriteDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#writedataviaquery)
+ [nettuno-db: DeleteDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#deletedataviaquery)

[Nota che la chiave di condizione [QueryLanguageIAM neptune-db ::Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) può essere utilizzata nel documento di policy per limitare l'uso delle query Gremlin (vedi Condition keys available in Neptune IAM data-access policy).](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html)

**Richiesta**
+ **gremlinQuery** (nella CLI: `--gremlin-query`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Utilizza questa API per eseguire le query Gremlin in formato stringa, in modo simile all'uso dell'endpoint HTTP. L'interfaccia è compatibile con qualsiasi versione di Gremlin utilizzata dal cluster database (consulta la [sezione relativa al client Tinkerpop](https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-gremlin-client.html#best-practices-gremlin-java-latest) per determinare quali rilasci di Gremlin sono supportati dalla versione del motore).
+ **serializer** (nella CLI: `--serializer`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  Se diverso da null, i risultati della query vengono restituiti in un messaggio di risposta serializzato nel formato specificato da questo parametro. Consulta la sezione [GraphSon](https://tinkerpop.apache.org/docs/current/reference/#_graphson) nella TinkerPop documentazione per un elenco dei formati attualmente supportati.

**Risposta**
+ **meta**: un documento di tipo `document` (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON).

  I metadati relativi alla query Gremlin.
+ **requestId**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'identificatore univoco della query Gremlin.
+ **result**: un documento di tipo `document` (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON).

  L'output della query Gremlin dal server.
+ **status**: un oggetto [GremlinQueryStatusAttributes](#GremlinQueryStatusAttributes).

  Lo stato della query Gremlin.

**Errori**
+ [QueryTooLargeException](data-api-dp-errors.md#QueryTooLargeException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [QueryLimitExceededException](data-api-dp-errors.md#QueryLimitExceededException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [QueryLimitException](data-api-dp-errors.md#QueryLimitException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [CancelledByUserException](data-api-dp-errors.md#CancelledByUserException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [MemoryLimitExceededException](data-api-dp-errors.md#MemoryLimitExceededException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [MalformedQueryException](data-api-dp-errors.md#MalformedQueryException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## ExecuteGremlinExplainQuery (azione)
ExecuteGremlinExplainQuery

         Il nome AWS CLI per questa API è:. `execute-gremlin-explain-query`

Esegue una query "explain" di Gremlin.

Amazon Neptune ha aggiunto una funzionalità Gremlin denominata `explain` che fornisce uno strumento self-service per comprendere l'approccio di esecuzione adottato dal motore Neptune per la query. È possibile richiamarla aggiungendo un parametro `explain` a una chiamata HTTP che invia una query Gremlin.

La funzionalità "explain" fornisce informazioni sulla struttura logica dei piani di esecuzione delle query. Puoi utilizzare queste informazioni per identificare potenziali problemi di valutazione ed esecuzione, oltre che per ottimizzare la query, come spiegato in [Ottimizzazione delle query Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-traversal-tuning.html). Puoi quindi utilizzare gli hint di query per migliorare i piani di esecuzione delle query.

Quando si richiama questa operazione in un cluster Neptune in cui è abilitata l'autenticazione IAM, all'utente o al ruolo IAM che effettua la richiesta deve essere associata una policy che consenta una delle seguenti azioni IAM nel cluster, a seconda della query:
+ [neptune-db: ReadDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#readdataviaquery)
+ [nettuno-db: WriteDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#writedataviaquery)
+ [nettuno-db: DeleteDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#deletedataviaquery)

[Nota che la chiave di condizione [QueryLanguageIAM neptune-db ::Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) può essere utilizzata nel documento di policy per limitare l'uso delle query Gremlin (vedi Condition keys available in Neptune IAM data-access policy).](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html)

**Richiesta**
+ **gremlinQuery** (nella CLI: `--gremlin-query`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La stringa della query "explain" di Gremlin.

**Risposta**
+ **output**— a, di tipo: (un blocco di dati binari non interpretati). ReportAsText `blob`

  Un blob di testo contenente il risultato della query "explain" di Gremlin, come descritto in [Ottimizzazione delle query Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-traversal-tuning.html).

**Errori**
+ [QueryTooLargeException](data-api-dp-errors.md#QueryTooLargeException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [QueryLimitExceededException](data-api-dp-errors.md#QueryLimitExceededException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [QueryLimitException](data-api-dp-errors.md#QueryLimitException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [CancelledByUserException](data-api-dp-errors.md#CancelledByUserException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [MemoryLimitExceededException](data-api-dp-errors.md#MemoryLimitExceededException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [MalformedQueryException](data-api-dp-errors.md#MalformedQueryException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## ExecuteGremlinProfileQuery (azione)
ExecuteGremlinProfileQuery

         Il nome AWS CLI per questa API è:. `execute-gremlin-profile-query`

Esegue una query "profile" di Gremlin che esegue un attraversamento Gremlin specificato, raccoglie varie metriche relative all'esecuzione e produce un report del profilo come output. Per i dettagli, consulta [API profile di Gremlin in Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-profile-api.html).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [ReadDataViaQueryneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#readdataviaquery): IAM in quel cluster.

[Nota che la chiave di condizione [QueryLanguageIAM neptune-db ::Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) può essere utilizzata nel documento di policy per limitare l'uso delle query Gremlin (vedi Condition keys available in Neptune IAM data-access policy).](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html)

**Richiesta**
+ **chop** (nella CLI: `--chop`): un valore Integer di tipo `integer` (numero intero a 32 bit con segno).

  Se diverso da zero, la stringa dei risultati viene troncata a tale numero di caratteri. Se impostato su zero, la stringa contiene tutti i risultati.
+ **gremlinQuery** (nella CLI: `--gremlin-query`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La stringa di query Gremlin per il profilo.
+ **indexOps** (nella CLI: `--index-ops`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Se il flag è impostato su `TRUE`, mostra un report dettagliato di tutte le operazioni sugli indici eseguite durante l'esecuzione e la serializzazione delle query.
+ **results** (nella CLI: `--results`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Se il flag è impostato su `TRUE`, i risultati della query vengono raccolti e visualizzati come parte del report del profilo. Se `FALSE`, viene visualizzato solo il conteggio dei risultati.
+ **serializer** (nella CLI: `--serializer`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  Se diverso da null, i risultati raccolti vengono restituiti in un messaggio di risposta serializzato nel formato specificato da questo parametro. Per ulteriori informazioni, consulta [API profile di Gremlin in Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-profile-api.html).

**Risposta**
+ **output**— a, di tipo: (un blocco di dati binari non interpretati). ReportAsText `blob`

  Un blob di testo contenente il risultato della query profile di Gremlin. Per i dettagli, consulta [API profile di Gremlin in Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-profile-api.html).

**Errori**
+ [QueryTooLargeException](data-api-dp-errors.md#QueryTooLargeException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [QueryLimitExceededException](data-api-dp-errors.md#QueryLimitExceededException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [QueryLimitException](data-api-dp-errors.md#QueryLimitException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [CancelledByUserException](data-api-dp-errors.md#CancelledByUserException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [MemoryLimitExceededException](data-api-dp-errors.md#MemoryLimitExceededException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [MalformedQueryException](data-api-dp-errors.md#MalformedQueryException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## ListGremlinQueries (azione)
ListGremlinQueries

         Il nome AWS CLI per questa API è:. `list-gremlin-queries`

Elenca le query Gremlin attive. Per i dettagli sull'output, vedi [API di stato delle query Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-api-status.html).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [GetQueryStatusneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getquerystatus): IAM in quel cluster.

[Nota che la chiave di condizione [QueryLanguageIAM neptune-db ::Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) può essere utilizzata nel documento di policy per limitare l'uso delle query Gremlin (vedi Condition keys available in Neptune IAM data-access policy).](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html)

**Richiesta**
+ **includeWaiting** (nella CLI: `--include-waiting`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Se impostato su `TRUE`, l'elenco restituito include le query in attesa. Il valore predefinito è `FALSE`;

**Risposta**
+ **acceptedQueryCount**: un numero intero di tipo `integer` (numero intero a 32 bit con segno).

  Numero di query accettate ma non ancora completate, incluse le query nella coda.
+ **queries**: una matrice di oggetti [GremlinQueryStatus](#GremlinQueryStatus).

  Un elenco delle query correnti.
+ **runningQueryCount**: un numero intero di tipo `integer` (numero intero a 32 bit con segno).

  Il numero di query Gremlin attualmente in esecuzione.

**Errori**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## GetGremlinQueryStatus (azione)
GetGremlinQueryStatus

         Il nome AWS CLI per questa API è:. `get-gremlin-query-status`

Ottiene lo stato di una query Gremlin specificata.

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [GetQueryStatusneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getquerystatus): IAM in quel cluster.

[Nota che la chiave di condizione [QueryLanguageIAM neptune-db ::Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) può essere utilizzata nel documento di policy per limitare l'uso delle query Gremlin (vedi Condition keys available in Neptune IAM data-access policy).](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html)

**Richiesta**
+ **queryId** (nella CLI: `--query-id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'identificatore univoco della query Gremlin.

**Risposta**
+ **queryEvalStats**: un oggetto [QueryEvalStats](#QueryEvalStats).

  Lo stato di valutazione della query Gremlin.
+ **queryId**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ID della query per la quale viene restituito lo stato.
+ **queryString**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  La stringa di query Gremlin.

**Errori**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## CancelGremlinQuery (azione)
CancelGremlinQuery

         Il nome AWS CLI per questa API è:. `cancel-gremlin-query`

Annulla una query Gremlin. Per ulteriori informazioni, consulta [Annullamento delle query Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-api-status-cancel.html).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [CancelQueryneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#cancelquery): IAM in quel cluster.

**Richiesta**
+ **queryId** (nella CLI: `--query-id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'identificatore univoco della query da annullare.

**Risposta**
+ **status**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Lo stato dell'annullamento

**Errori**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## *Azioni di query openCypher:*
\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1

## ExecuteOpenCypherQuery (azione)
ExecuteOpenCypherQuery

         Il nome AWS CLI per questa API è:. `execute-open-cypher-query`

Esegue una query openCypher. Per ulteriori informazioni, consulta [Accesso al grafo Neptune con openCypher](https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-opencypher.html).

Neptune supporta la creazione di applicazioni a grafo mediante openCypher, che è attualmente uno dei linguaggi di query più popolari tra gli sviluppatori che lavorano con database a grafo. Sviluppatori, analisti aziendali e data scientist apprezzano la sintassi dichiarativa di openCypher ispirata a SQL perché fornisce una struttura familiare mediante la quale eseguire query su grafi di proprietà.

Il linguaggio openCypher è stato sviluppato originariamente da Neo4j, per poi diventare open source nel 2015, e ha contribuito al [progetto openCypher](https://opencypher.org/) con una licenza open source Apache 2.

Tieni presente che, quando richiami questa operazione in un cluster Neptune in cui è abilitata l'autenticazione IAM, all'utente o al ruolo IAM che effettua la richiesta deve essere associata una policy che consenta una delle seguenti azioni IAM nel cluster, a seconda della query:
+ [neptune-db: ReadDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#readdataviaquery)
+ [nettuno-db: WriteDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#writedataviaquery)
+ [nettuno-db: DeleteDataViaQuery](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#deletedataviaquery)

Nota anche che la chiave di condizione [neptune-db:QueryLanguage: OpenCypher](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) IAM può essere utilizzata nel documento sulla policy per limitare l'uso delle query OpenCypher (vedi [Condition keys available](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html) nelle policy policy di accesso ai dati di Neptune IAM).

**Richiesta**
+ **openCypherQuery** (nella CLI: `--open-cypher-query`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La stringa di query openCypher da eseguire.
+ **parameters** (nella CLI: `--parameters`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  I parametri di query openCypher per l'esecuzione delle query. Per ulteriori informazioni, consulta [Esempi di query con parametri openCypher](https://docs.aws.amazon.com/neptune/latest/userguide/opencypher-parameterized-queries.html).

**Risposta**
+ **results**: *Obbligatorio:* un documento di tipo `document` (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON).

  I risultati della query openCypher.

**Errori**
+ [QueryTooLargeException](data-api-dp-errors.md#QueryTooLargeException)
+ [InvalidNumericDataException](data-api-dp-errors.md#InvalidNumericDataException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [QueryLimitExceededException](data-api-dp-errors.md#QueryLimitExceededException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [QueryLimitException](data-api-dp-errors.md#QueryLimitException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [CancelledByUserException](data-api-dp-errors.md#CancelledByUserException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [MemoryLimitExceededException](data-api-dp-errors.md#MemoryLimitExceededException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [MalformedQueryException](data-api-dp-errors.md#MalformedQueryException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## ExecuteOpenCypherExplainQuery (azione)
ExecuteOpenCypherExplainQuery

         Il nome AWS CLI per questa API è:. `execute-open-cypher-explain-query`

Esegue una richiesta `explain` openCypher. Per ulteriori informazioni, consulta [Funzione explain di openCypher](https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-opencypher-explain.html).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [ReadDataViaQueryneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#readdataviaquery): IAM in quel cluster.

Nota che la chiave di condizione [neptune-db:QueryLanguage: OpenCypher](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) IAM può essere utilizzata nel documento relativo alla policy per limitare l'uso delle query OpenCypher (vedi [Condition keys available](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html) nelle policy policy di accesso ai dati di Neptune IAM).

**Richiesta**
+ **explainMode**(nella CLI:`--explain-mode`) — *Obbligatorio: an OpenCypherExplainMode, di tipo:* `string` (una stringa con codifica UTF-8).

  La modalità `explain` di openCypher. Può essere `static`, `dynamic` o `details`.
+ **openCypherQuery** (nella CLI: `--open-cypher-query`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  La stringa di query openCypher.
+ **parameters** (nella CLI: `--parameters`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  I parametri della query openCypher.

**Risposta**
+ **results**: *Obbligatorio:* un blob di tipo `blob` (un blocco di dati binari non interpretati).

  Un blob di testo contenente i risultati della query `explain` di openCypher.

**Errori**
+ [QueryTooLargeException](data-api-dp-errors.md#QueryTooLargeException)
+ [InvalidNumericDataException](data-api-dp-errors.md#InvalidNumericDataException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [QueryLimitExceededException](data-api-dp-errors.md#QueryLimitExceededException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [QueryLimitException](data-api-dp-errors.md#QueryLimitException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [CancelledByUserException](data-api-dp-errors.md#CancelledByUserException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [MemoryLimitExceededException](data-api-dp-errors.md#MemoryLimitExceededException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [MalformedQueryException](data-api-dp-errors.md#MalformedQueryException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## ListOpenCypherQueries (azione)
ListOpenCypherQueries

         Il nome AWS CLI per questa API è:. `list-open-cypher-queries`

Elenca le query openCypher attive. Per ulteriori informazioni, consulta [Endpoint dello stato openCypher di Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-opencypher-status.html).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [GetQueryStatusneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getquerystatus): IAM in quel cluster.

Nota che la chiave di condizione [neptune-db:QueryLanguage: OpenCypher](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) IAM può essere utilizzata nel documento relativo alla policy per limitare l'uso delle query OpenCypher (vedi [Condition keys available](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html) nelle policy policy di accesso ai dati di Neptune IAM).

**Richiesta**
+ **includeWaiting** (nella CLI: `--include-waiting`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

   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.

**Risposta**
+ **acceptedQueryCount**: un numero intero di tipo `integer` (numero intero a 32 bit con segno).

  Numero di query accettate ma non ancora completate, incluse le query nella coda.
+ **queries**: una matrice di oggetti [GremlinQueryStatus](#GremlinQueryStatus).

  Un elenco delle query openCypher correnti.
+ **runningQueryCount**: un numero intero di tipo `integer` (numero intero a 32 bit con segno).

  Il numero di query openCypher attualmente in esecuzione.

**Errori**
+ [InvalidNumericDataException](data-api-dp-errors.md#InvalidNumericDataException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## GetOpenCypherQueryStatus (azione)
GetOpenCypherQueryStatus

         Il nome AWS CLI per questa API è:. `get-open-cypher-query-status`

Recupera lo stato di una query openCypher specificata.

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [GetQueryStatusneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getquerystatus): IAM in quel cluster.

Nota che la chiave di condizione [neptune-db:QueryLanguage: OpenCypher](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html#iam-neptune-condition-keys) IAM può essere utilizzata nel documento relativo alla policy per limitare l'uso delle query OpenCypher (vedi [Condition keys available](https://docs.aws.amazon.com/neptune/latest/userguide/iam-data-condition-keys.html) nelle policy policy di accesso ai dati di Neptune IAM).

**Richiesta**
+ **queryId** (nella CLI: `--query-id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ID univoco della query openCypher per la quale recuperare lo stato.

**Risposta**
+ **queryEvalStats**: un oggetto [QueryEvalStats](#QueryEvalStats).

  Lo stato di valutazione della query openCypher.
+ **queryId**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ID univoco della query per la quale viene restituito lo stato.
+ **queryString**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  La stringa di query openCypher.

**Errori**
+ [InvalidNumericDataException](data-api-dp-errors.md#InvalidNumericDataException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [AccessDeniedException](data-api-dp-errors.md#AccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ReadOnlyViolationException](data-api-dp-errors.md#ReadOnlyViolationException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## CancelOpenCypherQuery (azione)
CancelOpenCypherQuery

         Il nome AWS CLI per questa API è:. `cancel-open-cypher-query`

Annulla una query openCypher specificata. Per ulteriori informazioni, consulta [Endpoint dello stato openCypher di Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-opencypher-status.html).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [CancelQueryneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#cancelquery): IAM in quel cluster.

**Richiesta**
+ **queryId** (nella CLI: `--query-id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ID univoco della query openCypher da annullare.
+ **silent** (nella CLI: `--silent`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Se impostato su `TRUE`, l'annullamento della query openCypher avviene senza alcun avviso.

**Risposta**
+ **payload**: un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Il payload dell'annullamento per la query openCypher.
+ **status**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Lo stato di annullamento della query openCypher.

**Errori**
+ [InvalidNumericDataException](data-api-dp-errors.md#InvalidNumericDataException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [FailureByQueryException](data-api-dp-errors.md#FailureByQueryException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ParsingException](data-api-dp-errors.md#ParsingException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [TimeLimitExceededException](data-api-dp-errors.md#TimeLimitExceededException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)
+ [ConcurrentModificationException](data-api-dp-errors.md#ConcurrentModificationException)

## *Strutture di query:*
\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1\$1

## QueryEvalStats (struttura)
QueryEvalStats

Struttura per acquisire statistiche sulle query, ad esempio quante query sono in esecuzione, accettate o in attesa e i relativi dettagli.

**Campi**
+ **cancelled**: questo è un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Impostato su `TRUE` se la query è stata annullata, in caso contrario FALSE.
+ **elapsed**: questo è un numero intero di tipo `integer`(numero intero a 32 bit con segno).

  Il numero di millisecondi durante i quali è stata eseguita la query (fino a questo momento).
+ **subqueries**: questo è un documento di tipo `document` (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON).

  Numero di sottoquery in questa query.
+ **waited**: questo è un numero intero di tipo `integer`(numero intero a 32 bit con segno).

  Indica il tempo di attesa della query, in millisecondi.

## GremlinQueryStatus (struttura)
GremlinQueryStatus

Acquisisce lo stato di una query Gremlin (vedi la pagina [API di stato delle query Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/gremlin-api-status.html)).

**Campi**
+ **queryEvalStats**: questo è un oggetto [QueryEvalStats](#QueryEvalStats).

  Le statistiche della query Gremlin.
+ **queryId**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ID della query Gremlin.
+ **queryString**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  La stringa della query Gremlin.

## GremlinQueryStatusAttributes (struttura)
GremlinQueryStatusAttributes

Contiene i componenti di stato di una query Gremlin.

**Campi**
+ **attributes**: questo è un documento di tipo `document` (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON).

  Attributi dello stato della query Gremlin.
+ **code**: questo è un numero intero di tipo `integer`(numero intero a 32 bit con segno).

  Il codice di risposta HTTP restituito dalla richiesta di query Gremlin.
+ **message**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il messaggio sullo stato.