本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
"
}
请求参数
有关所有操作的通用参数的信息,请参阅通用参数。
该请求接受以下JSON格式的数据。
- ClientToken
-
类型:字符串
长度限制:长度下限为 1。长度上限为 64。
必需:否
- DataModelConfiguration
-
类型:DataModelConfiguration 对象
必需:否
- DataSourceConfiguration
-
定义有关批量加载任务的数据源的配置详细信息。
类型:DataSourceConfiguration 对象
必需:是
- RecordVersion
-
类型:长整型
必需:否
- ReportConfiguration
-
报告批量加载任务的配置。其中包含有关错误报告的存储位置的详细信息。
类型:ReportConfiguration 对象
必需:是
- TargetDatabaseName
-
批量加载任务的目标时间流数据库。
类型:字符串
模式:
[a-zA-Z0-9_.-]+
必需:是
- TargetTableName
-
批量加载任务的目标时间流表。
类型:字符串
模式:
[a-zA-Z0-9_.-]+
必需:是
响应语法
{
"TaskId": "string"
}
响应元素
如果操作成功,服务将发回 HTTP 200 响应。
以下数据由服务以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,请参阅以下内容: