

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Einfügen einer benutzerdefinierten ID in eine Neptune-Gremlin- oder -SPARQL-Abfrage
<a name="features-query-id"></a>

Standardmäßig weist Neptune jeder Abfrage einen eindeutigen `queryId`-Wert zu. Sie können diese ID verwenden, um Informationen zu einer laufenden Abfrage abzurufen (siehe [Gremlin-Abfragestatus-API](gremlin-api-status.md) oder [SPARQL-Abfragestatus-API](sparql-api-status.md)) oder abzubrechen (siehe [Gremlin-Abfrageabbruch](gremlin-api-status-cancel.md) oder [SPARQL-Abfrageabbruch](sparql-api-status-cancel.md)).

Mit Neptune können Sie auch Ihren eigenen `queryId`-Wert für eine Gremlin- oder SPARQL-Abfrage angeben, entweder im HTTP-Header oder (für eine SPARQL-Abfrage) mithilfe des `queryId`-Abfragehinweises. Die Zuweisung Ihrer eigenen `queryID` macht es einfach, eine Abfrage nachzuverfolgen, um ihren Status abzurufen oder sie abzubrechen.

## Eingeben eines benutzerdefinierten `queryId`-Werts mithilfe des HTTP-Headers
<a name="features-query-id-header"></a>

Sowohl für Gremlin als auch für SPARQL kann der HTTP-Header verwendet werden, um Ihren eigenen `queryId`-Wert in eine Abfrage einzufügen.

**Gremlin-Beispiel**

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

**SPARQL-Beispiel**

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

## Eingeben eines benutzerdefinierten `queryId`-Werts mithilfe eines SPARQL-Abfragehinweises
<a name="features-query-id-hint"></a>

Hier ist ein Beispiel dafür, wie Sie den `queryId`-Abfragehinweis von SPARQL verwenden können, um einen benutzerdefinierten `queryId`-Wert in eine SPARQL-Abfrage einzufügen:

```
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}}"
```

## Verwenden des `queryId`-Werts zum Prüfen des Abfragestatus
<a name="features-query-id-check-status"></a>

**Gremlin-Beispiel**

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

**SPARQL-Beispiel**

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