Untuk kemampuan serupa dengan Amazon Timestream LiveAnalytics, pertimbangkan Amazon Timestream untuk InfluxDB. Ini menawarkan konsumsi data yang disederhanakan dan waktu respons kueri milidetik satu digit untuk analitik waktu nyata. Pelajari lebih lanjut [di sini](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

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

# PrepareQuery
<a name="API_query_PrepareQuery"></a>

Operasi sinkron yang memungkinkan Anda mengirimkan kueri dengan parameter yang akan disimpan oleh Timestream untuk dijalankan nanti. Timestream hanya mendukung penggunaan operasi ini dengan `ValidateOnly` set to`true`. 

## Sintaksis Permintaan
<a name="API_query_PrepareQuery_RequestSyntax"></a>

```
{
   "QueryString": "string",
   "ValidateOnly": boolean
}
```

## Parameter Permintaan
<a name="API_query_PrepareQuery_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-QueryString"></a>
String query Timestream yang ingin Anda gunakan sebagai pernyataan siap. Nama parameter dapat ditentukan dalam `@` karakter string query diikuti oleh identifier.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 262144.  
Wajib: Ya

 ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **   <a name="timestream-query_PrepareQuery-request-ValidateOnly"></a>
Dengan menyetel nilai ini`true`, Timestream hanya akan memvalidasi bahwa string kueri adalah kueri Timestream yang valid, dan tidak menyimpan kueri yang disiapkan untuk digunakan nanti.  
Tipe: Boolean  
Wajib: Tidak

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

```
{
   "Columns": [ 
      { 
         "Aliased": boolean,
         "DatabaseName": "string",
         "Name": "string",
         "TableName": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "Parameters": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "QueryString": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Columns"></a>
Daftar kolom klausa SELECT dari string kueri yang dikirimkan.   
Tipe: Array objek [SelectColumn](API_query_SelectColumn.md)

 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-Parameters"></a>
Daftar parameter yang digunakan dalam string kueri yang dikirimkan.   
Tipe: Array objek [ParameterMapping](API_query_ParameterMapping.md)

 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **   <a name="timestream-query_PrepareQuery-response-QueryString"></a>
String kueri yang ingin Anda siapkan.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 262144.

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

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

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk mengakses pengaturan akun.  
Kode Status HTTP: 400

 ** InternalServerException **   
Terjadi kesalahan server internal saat memproses permintaan.  
Kode Status HTTP: 400

 ** InvalidEndpointException **   
Endpoint yang diminta tidak valid.  
Kode Status HTTP: 400

 ** ThrottlingException **   
Permintaan itu dibatasi karena permintaan yang berlebihan.  
Kode Status HTTP: 400

 ** ValidationException **   
 Permintaan tidak valid atau cacat.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_query_PrepareQuery_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/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery)