如需與 Amazon Timestream for LiveAnalytics 類似的功能，請考慮使用 Amazon Timestream for InfluxDB。它提供簡化的資料擷取和單一位數毫秒查詢回應時間，以進行即時分析。[在這裡](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" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](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 資料庫。類型：字串模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** 批次載入任務的目標 Timestream 資料表。類型：字串模式：`[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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask)