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

# Inserimento di un ID personalizzato in una query Neptune Gremlin o SPARQL
<a name="features-query-id"></a>

Per impostazione predefinita, Neptune assegna un valore `queryId` univoco a ogni query. Puoi utilizzare questo ID per ottenere informazioni su una query in esecuzione (consulta [API di stato delle query Gremlin](gremlin-api-status.md) o [API di stato delle query SPARQL](sparql-api-status.md)) o annullarla (consulta [Annullamento delle query Gremlin](gremlin-api-status-cancel.md) o [Annullamento della query SPARQL](sparql-api-status-cancel.md)).

Neptune consente inoltre di specificare il proprio valore `queryId` per una query Gremlin o SPARQL, nell'intestazione HTTP o per una query SPARQL utilizzando l'hint di query `queryId`. L'assegnazione del proprio `queryID` consente di tenere traccia di una query in modo da ottenere lo stato o annullarla.

## Inserimento di un valore `queryId` personalizzato tramite l'intestazione HTTP
<a name="features-query-id-header"></a>

Per Gremlin e SPARQL, l'intestazione HTTP può essere utilizzata per inserire il proprio valore `queryId` in una query.

**Esempio Gremlin**

```
curl -XPOST https://your-neptune-endpoint:port \
    -d "{\"gremlin\": \
        \"g.V().limit(1).count()\" , \
        \"queryId\":\"4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47\"  }"
```

**Esempio SPARQL**

```
curl https://your-neptune-endpoint:port/sparql \
    -d "query=SELECT * WHERE { ?s ?p ?o } " \
       --data-urlencode \
       "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47"
```

## Inserimento di un valore `queryId` personalizzato mediante un hint di query SPARQL
<a name="features-query-id-hint"></a>

Di seguito è riportato un esempio di come utilizzare l'hint di query `queryId` SPARQL per inserire un valore `queryId` personalizzato in una query SPARQL:

```
curl https://your-neptune-endpoint:port/sparql \
    -d "query=PREFIX hint: <http://aws.amazon.com/neptune/vocab/v01/QueryHints#> \
       SELECT * WHERE { hint:Query hint:queryId \"4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47\" \
       {?s ?p ?o}}"
```

## Utilizzo del valore `queryId` per controllare lo stato della query
<a name="features-query-id-check-status"></a>

**Esempio Gremlin**

```
curl https://your-neptune-endpoint:port/gremlin/status \
    -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47"
```

**Esempio SPARQL**

```
curl https://your-neptune-endpoint:port/sparql/status \
    -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47"
```