As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Injetar um ID personalizado em uma consulta do Gremlin ou do SPARQL no Neptune
<a name="features-query-id"></a>

Por padrão, o Neptune atribui um valor exclusivo de `queryId` a cada consulta. Você pode usar esse ID para obter informações sobre uma consulta em execução (consulte [API de status de consulta do Gremlin](gremlin-api-status.md) ou [API de status de consulta do SPARQL](sparql-api-status.md)) ou para cancelá-la (consulte [Cancelamento de consultas do Gremlin](gremlin-api-status-cancel.md) ou [Cancelamento de consulta do SPARQL](sparql-api-status-cancel.md)).

O Neptune também permite que você especifique seu próprio valor de `queryId` para uma consulta do Gremlin ou do SPARQL, no cabeçalho HTTP ou para uma consulta do SPARQL usando a dica de consulta de `queryId`. A atribuição de seu próprio `queryID` facilita manter o controle de uma consulta para obter o status ou cancelá-la.

## Injetar um valor de `queryId` personalizado usando o cabeçalho HTTP
<a name="features-query-id-header"></a>

Para o Gremlin e o SPARQL, o cabeçalho HTTP pode ser usado para injetar seu próprio valor de `queryId` em uma consulta.

**Exemplo do Gremlin**

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

**Exemplo do SPARQL**

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

## Injetar um valor de `queryId` personalizado usando uma dica de consulta do SPARQL
<a name="features-query-id-hint"></a>

Veja a seguir um exemplo de como usar a dica de consulta `queryId` do SPARQL para injetar um valor de `queryId` personalizado em uma consulta do 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}}"
```

## Usar o valor de `queryId` para verificar o status da consulta
<a name="features-query-id-check-status"></a>

**Exemplo do Gremlin**

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

**Exemplo do SPARQL**

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