신중한 고려 끝에 두 단계로 Amazon Kinesis Data Analytics for SQL 애플리케이션을 단종하기로 결정했습니다.
1. 2025년 10월 15일부터 새 Kinesis Data Analytics for SQL 애플리케이션을 생성할 수 없습니다.
2. 2026년 1월 27일부터 애플리케이션이 삭제됩니다. Amazon Kinesis Data Analytics for SQL 애플리케이션을 시작하거나 작동할 수 없게 됩니다. 그 시점부터 Amazon Kinesis Data Analytics for SQL에 대한 지원을 더 이상 이용할 수 없습니다. 자세한 내용은 Amazon Kinesis Data Analytics for SQL 애플리케이션 단종 단원을 참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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.
Pattern:
[a-zA-Z0-9_.-]+
필수 여부: 예
- CurrentApplicationVersionId
-
준거 데이터 소스가 추가되는 애플리케이션의 버전입니다. DescribeApplication 작업을 사용하여 최신 애플리케이션 버전을 받을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우
ConcurrentModificationException
가 반환됩니다.타입: Long
유효 범위: 최소값 1. 최대값 999999999.
필수 여부: 예
- ReferenceDataSource
-
준거 데이터 소스는 Amazon S3 버킷의 객체일 수 있습니다. Amazon Kinesis Analytics는 객체를 읽고 생성된 애플리케이션 내 표에 데이터를 복사합니다. S3 버킷, 객체 키 명칭, 생성된 애플리케이션 내 표를 제공합니다. Amazon Kinesis Analytics가 사용자를 대신해 S3 버킷에서 객체를 읽기 위해 맡을 수 있는 IAM 역할도 제공해야 합니다.
유형: ReferenceDataSource 객체
필수 여부: 예
응답 요소
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.
오류
- ConcurrentModificationException
-
애플리케이션을 동시에 수정한 결과 예외가 발생했습니다. 예컨대, 두 사람이 동시에 같은 애플리케이션을 편집하려고 하는 경우를 예로 들 수 있습니다.
HTTP 상태 코드: 400
- InvalidArgumentException
-
지정한 입력 파라미터 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
이 작업을 위한 애플리케이션을 얻을 수 없습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정된 애플리케이션을 찾을 수 없습니다.
HTTP 상태 코드: 400
- UnsupportedOperationException
-
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDKs