Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateBatchLoadTask 新しい Timestream バッチロードタスクを作成します。バッチロードタスクは、S3 ロケーションの CSV ソースからのデータを処理し、Timestream テーブルに書き込みます。ソースからターゲットへのマッピングは、バッチロードタスクで定義されます。エラーとイベントは S3 ロケーションのレポートに書き込まれます。レポートでは、 AWS KMS キーが指定されていない場合、 `SSE_S3`が オプションの場合、レポートは S3 マネージドキーで暗号化されます。それ以外の場合は、エラーがスローされます。詳細については、[AWS マネージドキー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) を参照してください。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html)を参照してください。 ## リクエストの構文 ``` { "ClientToken": "string", "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "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" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "TargetDatabaseName": "string", "TargetTableName": "string" } ``` ## リクエストパラメーター すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下のデータを JSON 形式で受け入れます。 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) ** タイプ: 文字列 長さの制約: 最小長は 1 です。最大長 64 必須: いいえ ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 型: [DataModelConfiguration](API_DataModelConfiguration.md) オブジェクト 必須: いいえ ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのデータソースに関する設定の詳細を定義します。 型: [DataSourceConfiguration](API_DataSourceConfiguration.md) オブジェクト 必須: はい ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) ** タイプ: Long 必須: いいえ ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのレポート設定。これには、エラーレポートの保存先に関する詳細が含まれます。 型: [ReportConfiguration](API_ReportConfiguration.md) オブジェクト 必須: はい ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのターゲット Timestream データベース。 タイプ: 文字列 Pattern: `[a-zA-Z0-9_.-]+` 必須: はい ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのターゲット Timestream テーブル。 タイプ: 文字列 Pattern: `[a-zA-Z0-9_.-]+` 必須: はい ## レスポンスの構文 ``` { "TaskId": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) ** バッチロードタスクの ID。 タイプ: 文字列 長さの制約: 最小長は 3 です。最大長は 32 です。 パターン: `[A-Z0-9]+` ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** ConflictException ** Timestream は、既に存在するリソースが含まれているため、このリクエストを処理できませんでした。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 HTTP ステータスコード: 400 ** ServiceQuotaExceededException ** このアカウントにおけるリソースのインスタンスクォータを超過しました。 HTTP ステータスコード: 400 ** ThrottlingException ** ユーザーによるリクエストが多すぎたため、サービスクォータを超過しました。リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask)