

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Petunjuk `kueri QueryTimeout` SPARQL
<a name="sparql-query-hints-queryTimeout"></a>

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)`. Apakah akan mencoba lagi kueri waktu habis tergantung pada sifat kegagalan dan beban kerja Anda. Untuk panduan, lihat [Penanganan Pengecualian dan Mencoba Lagi](transactions-exceptions.md).

## `Sintaks petunjuk QueryTimeout` SPARQL
<a name="sparql-query-hints-queryTimeout-syntax"></a>

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

Ini harus diatur hanya sekali di semua bagian Pembaruan queries/subqueries dan 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](sparql-query-hints.md#sparql-query-hints-scope).

## `Contoh petunjuk QueryTimeout` SPARQL
<a name="sparql-query-hints-queryTimeout-example"></a>

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