Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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
-
유형: Long
필수 여부: 아니요
- ReportConfiguration
-
배치 로드 태스크에 대한 구성을 보고합니다. 여기에는 오류 보고서가 저장되는 위치에 대한 세부 정보가 포함됩니다.
타입: ReportConfiguration객체
필수 여부: 예
- TargetDatabaseName
-
배치 로드 태스크의 대상 Timestream 데이터베이스입니다.
유형: String
패턴:
[a-zA-Z0-9_.-]+필수 여부: 예
- TargetTableName
-
배치 로드 태스크의 대상 Timestream 테이블입니다.
유형: String
패턴:
[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
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.