

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Injection d'un ID personnalisé dans une requête Neptune Gremlin ou SPARQL
<a name="features-query-id"></a>

Par défaut, Neptune attribue une valeur `queryId` unique à chaque requête. Vous pouvez utiliser cet ID pour obtenir des informations sur une requête en cours d'exécution (voir [API de statut des requêtes Gremlin](gremlin-api-status.md) ou [API de statut des requêtes SPARQL](sparql-api-status.md)) ou pour l'annuler (voir [Annulation de requêtes Gremlin](gremlin-api-status-cancel.md) ou [Annulation de requêtes SPARQL](sparql-api-status-cancel.md)).

Neptune vous permet également de spécifier votre propre valeur `queryId` pour une requête Gremlin ou SPARQL, soit dans l'en-tête HTTP, soit pour une requête SPARQL à l'aide de l'indicateur de requête `queryId`. L'attribution de votre propre `queryID` permet de suivre facilement une requête afin d'obtenir son statut ou de l'annuler.

## Injection d'une valeur `queryId` personnalisée à l'aide de l'en-tête HTTP
<a name="features-query-id-header"></a>

Pour Gremlin et SPARQL, l'en-tête HTTP peut être utilisé pour injecter votre propre valeur `queryId` dans une requête.

**Exemple Gremlin**

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

**Exemple SPARQL**

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

## Injection d'une valeur `queryId` personnalisée à l'aide d'un indicateur de requête SPARQL
<a name="features-query-id-hint"></a>

Voici un exemple d'utilisation de l'indicateur de requête `queryId` SPARQL pour injecter une valeur `queryId` personnalisée dans une requête 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}}"
```

## Utilisation de la valeur `queryId` pour vérifier le statut de la requête
<a name="features-query-id-check-status"></a>

**Exemple Gremlin**

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

**Exemple SPARQL**

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