Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Inserte un identificador personalizado en una consulta de Neptune Gremlin o SPARQL
<a name="features-query-id"></a>

De forma predeterminada, Neptune asigna un valor `queryId` único a cada consulta. Puede utilizar este ID para obtener información sobre una consulta en ejecución (consulte [API del estado de la consulta de Gremlin](gremlin-api-status.md) o [API de estado de la consulta SPARQL](sparql-api-status.md)) o cancelarla (consulte [Cancelación de consultas de Gremlin](gremlin-api-status-cancel.md) o [Cancelación de consultas SPARQL](sparql-api-status-cancel.md)).

Neptune también le permite especificar su propio valor `queryId` para una consulta de Gremlin o SPARQL, ya sea en el encabezado HTTP o para una consulta SPARQL mediante la sugerencia de la consulta `queryId`. La asignación de su propio `queryID` facilita la realización de un seguimiento de una consulta para obtener el estado o cancelarlo.

## Inserción de un valor `queryId` personalizado mediante el encabezado HTTP
<a name="features-query-id-header"></a>

Tanto para Gremlin como para SPARQL, el encabezado HTTP se puede utilizar para insertar su propio valor `queryId` en una consulta.

**Ejemplo de Gremlin**

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

**Ejemplo de SPARQL**

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

## Inserción de un valor `queryId` personalizado mediante una sugerencia de consulta SPARQL
<a name="features-query-id-hint"></a>

A continuación se muestra un ejemplo de cómo utilizaría la sugerencia de la consulta `queryId` SPARQL para insertar un valor `queryId` personalizado en una consulta 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}}"
```

## Uso del valor `queryId` para comprobar el estado de la consulta
<a name="features-query-id-check-status"></a>

**Ejemplo de Gremlin**

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

**Ejemplo de SPARQL**

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