기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AddApplicationReferenceDataSource
기존 SQL 기반 Amazon Kinesis Data Analytics 애플리케이션에 참조 데이터 원본을 추가합니다.
Kinesis Data Analytics는 참조 데이터(즉, Amazon S3 객체)를 읽고 애플리케이션 내에 인애플리케이션 테이블을 만듭니다. 요청에서 소스(S3 버킷 이름과 객체 키 이름), 생성할 인애플리케이션 테이블의 이름, Amazon S3 객체의 데이터가 결과 인애플리케이션 테이블의 열에 매핑하는 방법을 설명하는 필요한 매핑 정보를 제공합니다.
구문 요청
{
"ApplicationName": "string
",
"CurrentApplicationVersionId": number
,
"ReferenceDataSource": {
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncoding": "string
",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"S3ReferenceDataSource": {
"BucketARN": "string
",
"FileKey": "string
"
},
"TableName": "string
"
}
}
요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ApplicationName
-
기존 애플리케이션의 이름입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴:
[a-zA-Z0-9_.-]+
필수 사항 여부: Yes
- CurrentApplicationVersionId
-
참조 데이터 소스를 추가할 애플리케이션의 버전입니다. DescribeApplication 작업을 사용하여 현재 애플리케이션 버전을 가져올 수 있습니다. 지정한 버전이 현재 버전이 아닌 경우
ConcurrentModificationException
이 반환됩니다.타입: Long
유효 범위: 최소값 1. 최대값 999999999.
필수 여부: 예
- ReferenceDataSource
-
준거 데이터 소스는 Amazon S3 버킷의 객체일 수 있습니다. Kinesis Data Analytics는 객체를 읽고 생성된 애플리케이션 내 테이블에 데이터를 복사합니다. S3 버킷, 객체 키 명칭, 생성된 애플리케이션 내 표를 제공합니다.
유형: ReferenceDataSource객체
필수 여부: 예
응답 구문
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"ReferenceDataSourceDescriptions": [
{
"ReferenceId": "string",
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSourceDescription": {
"BucketARN": "string",
"FileKey": "string",
"ReferenceRoleARN": "string"
},
"TableName": "string"
}
]
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- ApplicationARN
-
애플리케이션 Amazon 리소스 이름(ARN).
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 2,048.
패턴:
arn:.*
- ApplicationVersionId
-
업데이트된 애플리케이션 버전 ID입니다. Kinesis Data Analytics는 애플리케이션이 업데이트될 때 이 ID를 증가시킵니다.
타입: Long
유효 범위: 최소값 1. 최대 값은 999999999입니다.
- ReferenceDataSourceDescriptions
-
애플리케이션에 대해 구성된 참조 데이터 소스에 대해 설명합니다.
타입: ReferenceDataSourceDescription 객체 배열
Errors
- ConcurrentModificationException
-
애플리케이션의 동시 수정으로 인해 발생한 예외입니다. 이 오류는 현재 애플리케이션 ID를 사용하지 않고 애플리케이션을 수정하려고 시도한 경우 발생할 수 있습니다.
HTTP 상태 코드: 400
- InvalidArgumentException
-
지정한 입력 파라미터 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- InvalidRequestException
-
요청 JSON이 작업에 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
이 작업에는 애플리케이션을 사용할 수 없습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정된 애플리케이션을 찾을 수 없습니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.