새 프로젝트의 경우 Kinesis Data Analytics for SQL 애플리케이션보다 새로운 Managed Service for Apache Flink Studio를 사용하는 것이 좋습니다. Managed Service for Apache Flink Studio는 사용 편의성과 고급 분석 기능을 결합하여 정교한 스트림 처리 애플리케이션을 몇 분 만에 구축할 수 있도록 합니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AddApplicationReferenceDataSource
참고
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 Amazon Kinesis Data Analytics API V2 설명서를 참조하십시오.
기존 애플리케이션에 준거 데이터 소스를 추가합니다.
Amazon Kinesis Analytics는 준거 데이터(즉, Amazon S3 객체)를 읽고 애플리케이션 내에 애플리케이션 내 표를 만듭니다. 요청에서 소스(S3 버킷 명칭과 객체 키 명칭), 생성할 애플리케이션 내 표의 명칭, Amazon S3 객체의 데이터가 결과 애플리케이션 내 표의 열에 매핑하는 방법을 설명하는 필요한 매핑 정보를 제공합니다.
개념 정보는 애플리케이션 입력 구성을 참조하십시오. 애플리케이션에 추가할 수 있는 데이터 소스에 대한 한도는 한도를 참조하십시오.
이 작업에는 kinesisanalytics:AddApplicationOutput 조치를 수행할 권한이 요구됩니다.
구문 요청
{
"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",
"ReferenceRoleARN": "string"
},
"TableName": "string"
}
}요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ApplicationName
-
기존 애플리케이션의 명칭입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴:
[a-zA-Z0-9_.-]+필수 사항 여부: Yes
- CurrentApplicationVersionId
-
준거 데이터 소스가 추가되는 애플리케이션의 버전입니다. DescribeApplication작업을 사용하여 현재 애플리케이션 버전을 가져올 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우
ConcurrentModificationException가 반환됩니다.타입: Long
유효 범위: 최소값 1. 최대값 999999999.
필수 여부: 예
- ReferenceDataSource
-
준거 데이터 소스는 Amazon S3 버킷의 객체일 수 있습니다. Amazon Kinesis Analytics는 객체를 읽고 생성된 애플리케이션 내 표에 데이터를 복사합니다. S3 버킷, 객체 키 명칭, 생성된 애플리케이션 내 표를 제공합니다. Amazon Kinesis Analytics가 사용자를 대신해 S3 버킷에서 객체를 읽기 위해 맡을 수 있는 IAM 역할도 제공해야 합니다.
유형: ReferenceDataSource객체
필수 여부: 예
Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 반송합니다.
Errors
- ConcurrentModificationException
-
애플리케이션을 동시에 수정한 결과 예외가 발생했습니다. 예컨대, 두 사람이 동시에 같은 애플리케이션을 편집하려고 하는 경우를 예로 들 수 있습니다.
HTTP 상태 코드: 400
- InvalidArgumentException
-
지정한 입력 파라미터 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
이 작업을 위한 애플리케이션을 얻을 수 없습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정된 애플리케이션을 찾을 수 없습니다.
HTTP 상태 코드: 400
- UnsupportedOperationException
-
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
