將自訂 ID 注入 Neptune Gremlin 或SPARQL查詢 - Amazon Neptune
使用HTTP標頭使用SPARQL查詢提示使用 queryId 檢查狀態

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將自訂 ID 注入 Neptune Gremlin 或SPARQL查詢

根據預設，Neptune 會將唯一 queryId 值指派給每個查詢。您可以使用此 ID 來取得執行中查詢的相關資訊 (請參閱Gremlin 查詢狀態 API 或 SPARQL 查詢狀態 API)，或取消它 (請參閱Gremlin 查詢取消或SPARQL 查詢取消)。

Neptune 也可讓您使用SPARQL查詢提示，在 HTTP 標頭中或SPARQL查詢指定自己的 Gremlin 或queryId查詢queryId值。指派您自己的 queryID 可讓您輕鬆追蹤查詢，以取得狀態或取消該查詢。

注意

從 版本 1.0.1.0.200463.0 (2019 年 10 月 15 日) 開始就可以使用這項功能。

使用HTTP標頭注入自訂queryId值

對於 Gremlin 和 SPARQL， HTTP標頭可用來將您自己的queryId值注入查詢。

Gremlin 範例

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

SPARQL 範例

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

使用SPARQL查詢提示注入自訂queryId值

以下是如何使用SPARQLqueryId查詢提示將自訂queryId值注入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}}"

使用 queryId 值檢查查詢狀態

Gremlin 範例

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

SPARQL 範例

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