Neptune Gremlin 또는 SPARQL 쿼리에 사용자 지정 ID 주입

기본적으로 Neptune은 모든 쿼리에 고유한 queryId 값을 할당합니다. 이 ID를 사용해 실행 중인 쿼리에 대한 정보를 가져오거나(Gremlin 쿼리 상태 API 또는 SPARQL 쿼리 상태 API 참조) 이를 취소할 수 있습니다(Gremlin 쿼리 취소 또는 SPARQL 쿼리 취소 참조).

또한 Neptune의 경우 HTTP 헤더에서, 또는 queryId 쿼리 힌트를 사용하여 SPARQL 쿼리에서 Gremlin 또는 SPARQL 쿼리에 대해 자체적인 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 값을 주입

아래에는 SPARQL queryId 쿼리 힌트를 사용해 SPARQL 쿼리에 사용자 지정 queryId 값을 주입하는 방법에 대한 예제가 나와 있습니다.

curl https://your-neptune-endpoint:port/sparql \
    -d "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"