本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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,請參閱下列內容: