Petunjuk kueri SPARQL queryTimeout

Petunjuk kueri queryTimeout menentukan batas waktu yang lebih pendek dari nilai neptune_query_timeout yang ditetapkan dalam grup parameter DB.

Jika kueri diakhiri sebagai hasil dari petunjuk ini, TimeLimitExceededException dilemparkan, dengan pesan Operation terminated (deadline exceeded).

Sintaks petunjuk SPARQ queryTimeout

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 .
 ...
}

Nilai batas waktu dinyatakan dalam milidetik.

Nilai batas waktu harus lebih kecil dari nilai neptune_query_timeout yang ditetapkan dalam grup parameter DB. Jika tidak, pengecualian MalformedQueryException dilemparkan dengan pesan Malformed query: Query hint 'queryTimeout' must be less than neptune_query_timeout DB Parameter Group.

Petunjuk kueri queryTimeout harus ditentukan dalam klausa WHERE dari kueri utama, atau dalam klausa WHERE dari salah satu subqueries seperti yang ditunjukkan pada contoh di bawah ini.

Petunjuk kueri harus ditetapkan hanya sekali di semua queries/subqueries dan bagian Updates SPARQL (seperti INSERT dan DELETE). Jika tidak, pengecualian MalformedQueryException dilemparkan dengan pesan Malformed query: Query hint 'queryTimeout' must be set only once.

Cakupan yang Tersedia

Petunjuk queryTimeout dapat diterapkan baik untuk kueri dan update SPARQL.

• Dalam kueri SPARQL, petunjuk dapat muncul di klausa WHERE dari kueri utama atau subkueri.

• Dalam update SPARQL, petunjuk dapat diatur dalam klausa INSERT, DELETE, atau WHERE. Jika ada beberapa klausa pembaruan, petunjuk hanya dapat diatur dalam salah satu dari klausa tersebut.

Untuk informasi lebih lanjut tentang cakupan petunjuk kueri, lihat Cakupan petunjuk kueri SPARQL di Neptune.

Contoh petunjuk SPARQL queryTimeout

Berikut adalah contoh penggunaan hint:queryTimeout di klausa WHERE utama dari kueri UPDATE:

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

Di sini, hint:queryTimeout berada di klausa WHERE dari subkueri:

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 .
      }
   }
}