如需與 Amazon Timestream for LiveAnalytics 類似的功能，請考慮使用 Amazon Timestream for InfluxDB。它提供簡化的資料擷取和單一位數毫秒查詢回應時間，以進行即時分析。[在這裡](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)進一步了解。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateScheduledQuery 建立將按照設定的排程代表您執行的排程查詢。Timestream 假定提供的執行角色作為用於執行查詢的部分 `ScheduledQueryExecutionRoleArn` 參數。您可以使用 `NotificationConfiguration` 參數為排程查詢操作設定通知。 ## 請求語法 ``` { "ClientToken": "string", "ErrorReportConfiguration": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "ObjectKeyPrefix": "string" } }, "KmsKeyId": "string", "Name": "string", "NotificationConfiguration": { "SnsConfiguration": { "TopicArn": "string" } }, "QueryString": "string", "ScheduleConfiguration": { "ScheduleExpression": "string" }, "ScheduledQueryExecutionRoleArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TargetConfiguration": { "TimestreamConfiguration": { "DatabaseName": "string", "DimensionMappings": [ { "DimensionValueType": "string", "Name": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TableName": "string", "TimeColumn": "string" } } } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) ** 使用 ClientToken 呼叫 CreateScheduledQuery 等冪，換句話說，重複提出相同的請求將產生相同的結果。提出多個相同的 CreateScheduledQuery 請求與提出單一請求具有相同的效果。 + 如果在沒有 `ClientToken` 的情況下呼叫 CreateScheduledQuery，則查詢 SDK 會代表您產生 `ClientToken`。 + 8 小時後，任何具有相同 `ClientToken` 的請求會視為新的請求。類型：字串長度限制：長度下限為 32。長度上限為 128。必要：否 ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 錯誤報告的組態。寫入查詢結果時遇到問題時，會產生錯誤報告。類型：[ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) 物件必要：是 ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) ** 用於靜態加密排程查詢資源的 Amazon KMS 金鑰。如果未指定 Amazon KMS 金鑰，則會使用 Timestream 擁有的 Amazon KMS 金鑰來加密排程查詢資源。若要指定 KMS 金鑰，請使用金鑰 ID、金鑰 ARN、別名名稱或別名 ARN。使用別名時，請在名稱加上 *alias/* 字首。如果 ErrorReportConfiguration 使用 `SSE_KMS` 作為加密類型，則使用相同的 KmsKeyId 來靜態加密錯誤報告。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) ** 排程查詢的名稱。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必要：是 ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 排程查詢的通知組態。Timestream 會在查詢執行完成時、狀態更新或刪除查詢時傳送通知。類型：[NotificationConfiguration](API_query_NotificationConfiguration.md) 物件必要：是 ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) ** 要執行的查詢字串。參數名稱可以在後跟一個識別碼的查詢字串 `@` 字元中指定。命名參數 `@scheduled_runtime` 是保留的，並且可以在查詢中使用，以取得排程執行查詢的時間。根據 ScheduleConfiguration 參數計算的時間戳記將是每次查詢執行的 `@scheduled_runtime` 參數值。例如，假設某個排程查詢執行個體是在 2021-12-01 00:00:00 執行。在此執行個體中，在叫用查詢時，`@scheduled_runtime` 參數會初始化為時間戳記 2021-12-01 00:00:00。類型：字串長度限制：長度下限為 1。長度上限為 262144。必要：是 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 查詢的排程組態。類型：[ScheduleConfiguration](API_query_ScheduleConfiguration.md) 物件必要：是 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) ** 執行排程查詢時，Timestream 將擔任之 IAM 角色的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) ** 用來標示排程查詢的鍵/值對清單。類型：[Tag](API_query_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 用於寫入查詢結果的組態。類型：[TargetConfiguration](API_query_TargetConfiguration.md) 物件必要：否 ## 回應語法 ``` { "Arn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) ** 已建立排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您沒有存取帳戶設定的必要許可。 HTTP 狀態碼：400 ** ConflictException ** 無法輪詢已取消查詢的結果。 HTTP 狀態碼：400 ** InternalServerException ** 處理請求時發生內部伺服器錯誤。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 您已超過服務配額。 HTTP 狀態碼：400 ** ThrottlingException ** 請求因請求過多而受到限流。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)