queryTimeout SPARQL 쿼리 힌트

queryTimeout 쿼리 힌트는 DB 파라미터 그룹에 설정된 neptune_query_timeout 값보다 작은 제한 시간을 지정합니다.

이 힌트의 결과로 쿼리가 종료되면 Operation terminated (deadline exceeded) 메시지와 함께 TimeLimitExceededException이 발생합니다.

queryTimeout SPARQL 힌트 구문

PREFIX hint: <http://aws.amazon.com/neptune/vocab/v01/QueryHints#>
SELECT ... WHERE {
    hint:Query hint:queryTimeout 10 .
    # OR
    hint:Query hint:queryTimeout "10" .
    # OR
    hint:Query hint:queryTimeout "10"^^xsd:integer .
 ...
}

제한 시간 값은 밀리초로 표시됩니다.

제한 시간 값은 DB 파라미터 그룹에 설정된 neptune_query_timeout 값보다 작아야 합니다. 그렇지 않으면 Malformed query: Query hint 'queryTimeout' must be less than neptune_query_timeout DB Parameter Group 메시지와 함께 MalformedQueryException 예외가 발생합니다.

queryTimeout 쿼리 힌트는 아래 예제에 표시된 대로 주 쿼리의 WHERE 절 또는 하위 쿼리 중 하나의 WHERE 절에 지정되어야 합니다.

모든 쿼리/하위 쿼리 및 SPARQL 업데이트 섹션(예: INSERT 및 DELETE)에서 한 번만 설정해야 합니다. 그렇지 않으면 Malformed query: Query hint 'queryTimeout' must be set only once 메시지와 함께 MalformedQueryException 예외가 발생합니다.

사용 가능한 범위

queryTimeout 힌트는 SPARQL 쿼리 및 업데이트에 모두 적용할 수 있습니다.

• SPARQL 쿼리에서는 기본 쿼리 또는 하위 쿼리의 WHERE 절에 나타날 수 있습니다.

• SPARQL 업데이트에서 INSERT, DELETE 또는 WHERE 절에서 설정할 수 있습니다. 여러 개의 업데이트 절이 있는 경우 그 중 하나에만 설정할 수 있습니다.

쿼리 힌트 범위에 대한 자세한 내용은 Neptune의 SPARQL 쿼리 힌트 범위 단원을 참조하십시오.

queryTimeout SPARQL 힌트 예제

다음은 UPDATE 쿼리의 주 WHERE 절에서 hint:queryTimeout을 사용하는 방법에 대한 예제입니다.

PREFIX hint: <http://aws.amazon.com/neptune/vocab/v01/QueryHints#>
INSERT {
    ?s ?p ?o
} WHERE {
    hint:Query hint:queryTimeout 100 .
    ?s ?p ?o .
}

여기서 hint:queryTimeout은 하위 쿼리의 WHERE 절입니다.

PREFIX hint: <http://aws.amazon.com/neptune/vocab/v01/QueryHints#>
SELECT * {
   ?s ?p ?o .
   {
      SELECT ?s WHERE {
         hint:Query hint:queryTimeout 100 .
         ?s ?p1 ?o1 .
      }
   }
}