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. # ExecuteScheduledQuery Anda dapat menggunakan API ini untuk menjalankan kueri terjadwal secara manual. Jika Anda mengaktifkan`QueryInsights`, API ini juga menampilkan insight dan metrik yang terkait dengan kueri yang Anda jalankan sebagai bagian dari notifikasi Amazon SNS. `QueryInsights`membantu penyetelan kinerja kueri Anda. Untuk informasi selengkapnya`QueryInsights`, lihat [Menggunakan wawasan kueri untuk mengoptimalkan kueri di Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html). ## Sintaksis Permintaan ``` { "ClientToken": "string", "InvocationTime": number, "QueryInsights": { "Mode": "string" }, "ScheduledQueryArn": "string" } ``` ## Parameter Permintaan Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md). Permintaan menerima data berikut dalam format JSON. ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) ** Tidak digunakan. Tipe: String Kendala Panjang: Panjang minimum 32. Panjang maksimum 128. Wajib: Tidak ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) ** Stempel waktu di UTC. Kueri akan dijalankan seolah-olah dipanggil pada stempel waktu ini. Tipe: Timestamp Wajib: Ya ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) ** Merangkum pengaturan untuk mengaktifkan. `QueryInsights` Mengaktifkan `QueryInsights` mengembalikan wawasan dan metrik sebagai bagian dari notifikasi Amazon SNS untuk kueri yang Anda jalankan. Anda dapat menggunakan `QueryInsights` untuk menyetel kinerja dan biaya kueri Anda. Tipe: Objek [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) Wajib: Tidak ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) ** ARN dari kueri terjadwal. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048. Wajib: Ya ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong. ## Kesalahan Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [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 ** ResourceNotFoundException ** Sumber daya yang diminta tidak dapat ditemukan. ** ScheduledQueryArn ** ARN dari kueri terjadwal. 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 ## Contoh ### Pesan pemberitahuan kueri terjadwal untuk mode ENABLED\$1WITH\$1RATE\$1CONTROL Contoh berikut menunjukkan pesan notifikasi kueri terjadwal yang berhasil untuk `ENABLED_WITH_RATE_CONTROL` mode `QueryInsights` parameter. ``` "SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:::scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723710546, "triggerTimeMillis": 1723710547490, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17343, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 }, "queryInsightsResponse": { "querySpatialCoverage": { "max": { "value": 1.0, "tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable", "partitionKey": [ "measure_name" ] } }, "queryTemporalRange": { "max": { "value": 2399999999999, "tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable" } }, "queryTableCount": 1, "outputRows": 1, "outputBytes": 59 } } } ``` ### Pesan pemberitahuan kueri terjadwal untuk mode DISABLED Contoh berikut menunjukkan pesan notifikasi kueri terjadwal yang berhasil untuk `DISABLED` mode `QueryInsights` parameter. ``` "SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:::scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723711401, "triggerTimeMillis": 1723711402144, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17992, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 } } } ``` ### Pesan pemberitahuan kegagalan untuk mode ENABLED\$1WITH\$1RATE\$1CONTROL Contoh berikut menunjukkan pesan pemberitahuan kueri terjadwal gagal untuk `ENABLED_WITH_RATE_CONTROL` mode `QueryInsights` parameter. ``` "FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915513, "triggerTimeMillis": 1727915513894, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } } ``` ### Pesan pemberitahuan kegagalan untuk mode DISABLED Contoh berikut menunjukkan pesan pemberitahuan kueri terjadwal gagal untuk `DISABLED` mode `QueryInsights` parameter. ``` "FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915194, "triggerTimeMillis": 1727915195119, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } } ``` ## Lihat Juga 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/ExecuteScheduledQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery)