CreateBatchLoadTask - Amazon Timestream

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

CreateBatchLoadTask

建立新的 Timestream 批次載入任務。批次載入任務會處理 S3 位置中CSV來源的資料,並寫入 Timestream 資料表。從來源到目標的映射會在批次載入任務中定義。錯誤和事件會寫入 S3 位置的報告。對於報告,如果未指定 AWS KMS 金鑰,則當 SSE_S3是 選項時,報告將使用 S3 受管金鑰加密。否則會擲回錯誤。如需詳細資訊,請參閱 AWS 受管金鑰服務配額適用。如需詳細資訊,請參閱程式碼範例

請求語法

{ "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》。

請求接受下列JSON格式的資料。

ClientToken

類型:字串

長度限制:長度下限為 1。長度上限為 64。

必要:否

DataModelConfiguration

類型:DataModelConfiguration 物件

必要:否

DataSourceConfiguration

定義批次載入任務之資料來源的組態詳細資訊。

類型:DataSourceConfiguration 物件

必要:是

RecordVersion

類型:Long

必要:否

ReportConfiguration

批次載入任務的報告組態。這包含錯誤報告存放位置的詳細資訊。

類型:ReportConfiguration 物件

必要:是

TargetDatabaseName

批次載入任務的目標 Timestream 資料庫。

類型:字串

模式:[a-zA-Z0-9_.-]+

必要:是

TargetTableName

批次載入任務的目標時間串流表。

類型:字串

模式:[a-zA-Z0-9_.-]+

必要:是

回應語法

{ "TaskId": "string" }

回應元素

如果動作成功,服務會傳回 200 HTTP 個回應。

服務會以 JSON 格式傳回下列資料。

TaskId

批次載入任務的 ID。

類型:字串

長度限制:長度下限為 3。長度上限為 32。

模式:[A-Z0-9]+

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

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

另請參閱

如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: