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

# ExecuteQuery
<a name="API_ExecuteQuery"></a>

Jalankan kueri untuk mengakses informasi dari grafik pengetahuan entitas dalam ruang kerja individual.

**catatan**  
 ExecuteQuery Tindakan ini hanya bekerja dengan [AWS Java SDK2](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html). ExecuteQuery tidak akan berfungsi dengan versi AWS Java SDK <2.x. 

## Minta Sintaks
<a name="API_ExecuteQuery_RequestSyntax"></a>

```
POST /queries/execution HTTP/1.1
Content-type: application/json

{
   "maxResults": number,
   "nextToken": "string",
   "queryStatement": "string",
   "workspaceId": "string"
}
```

## Parameter Permintaan URI
<a name="API_ExecuteQuery_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_ExecuteQuery_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [maxResults](#API_ExecuteQuery_RequestSyntax) **   <a name="tm-ExecuteQuery-request-maxResults"></a>
Jumlah maksimum hasil untuk kembali pada satu waktu. Defaultnya adalah 50.  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100.  
Wajib: Tidak

 ** [nextToken](#API_ExecuteQuery_RequestSyntax) **   <a name="tm-ExecuteQuery-request-nextToken"></a>
String yang menentukan halaman berikutnya dari hasil.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 17880.  
Pola: `.*`   
Wajib: Tidak

 ** [queryStatement](#API_ExecuteQuery_RequestSyntax) **   <a name="tm-ExecuteQuery-request-queryStatement"></a>
Pernyataan kueri.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1000.  
Pola: `[\s\S]+`   
Wajib: Ya

 ** [workspaceId](#API_ExecuteQuery_RequestSyntax) **   <a name="tm-ExecuteQuery-request-workspaceId"></a>
ID ruang kerja.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.  
Pola: `[a-zA-Z_0-9][a-zA-Z_\-0-9]*[a-zA-Z0-9]+`   
Diperlukan: Ya

## Sintaksis Respons
<a name="API_ExecuteQuery_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "columnDescriptions": [ 
      { 
         "name": "string",
         "type": "string"
      }
   ],
   "nextToken": "string",
   "rows": [ 
      { 
         "rowData": [ JSON value ]
      }
   ]
}
```

## Elemen Respons
<a name="API_ExecuteQuery_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [columnDescriptions](#API_ExecuteQuery_ResponseSyntax) **   <a name="tm-ExecuteQuery-response-columnDescriptions"></a>
Daftar ColumnDescription objek.  
Tipe: Array objek [ColumnDescription](API_ColumnDescription.md)

 ** [nextToken](#API_ExecuteQuery_ResponseSyntax) **   <a name="tm-ExecuteQuery-response-nextToken"></a>
String yang menentukan halaman berikutnya dari hasil.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 17880.  
Pola: `.*` 

 ** [rows](#API_ExecuteQuery_ResponseSyntax) **   <a name="tm-ExecuteQuery-response-rows"></a>
Merupakan satu baris dalam hasil query.  
Tipe: Array objek [Row](API_Row.md)

## Kesalahan
<a name="API_ExecuteQuery_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Akses ditolak.  
Kode Status HTTP: 403

 ** InternalServerException **   
Terjadi kesalahan tak terduga.  
Kode Status HTTP: 500

 ** QueryTimeoutException **   
Pengecualian batas waktu kueri.  
Kode Status HTTP: 400

 ** ServiceQuotaExceededException **   
Kuota layanan terlampaui.  
Kode Status HTTP: 402

 ** ThrottlingException **   
Tarif melebihi batas.  
Kode Status HTTP: 429

 ** ValidationException **   
Gagal  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_ExecuteQuery_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/iottwinmaker-2021-11-29/ExecuteQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/iottwinmaker-2021-11-29/ExecuteQuery)