Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](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" } } } ``` ## リクエストパラメーター すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下のデータを JSON 形式で受け入れます。 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) ** ClientToken を使用すると、createCheduledQuery の呼び出しがべき等になります。つまり、同じリクエストを繰り返し実行すると同じ結果が生成されます。同じ CreateScheduledQuery リクエストを複数回実行しても、1 回実行する場合と効果は同じです。 + CreateScheduledQuery が `ClientToken` がない状態で呼び出される場合、クエリ 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 です。最大長は 2,048 です。 必須: いいえ ** [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 です。最大長は 262,144 です。 必須: はい ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** クエリのスケジュール設定。 型: [ScheduleConfiguration](API_query_ScheduleConfiguration.md) オブジェクト 必須: はい ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) ** スケジュールされたクエリの実行時に Timestream が引き受ける IAM ロールの ARN。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 必須: はい ** [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 です。最大長は 2,048 です。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](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 SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery)