신중한 고려 끝에 Amazon Kinesis Data Analytics for SQL 애플리케이션을 중단하기로 결정했습니다.
1. **2025년 9월 1**일부터 Amazon Kinesis Data Analytics for SQL 애플리케이션에 대한 버그 수정은 제공되지 않습니다. 곧 중단될 예정이므로 지원이 제한될 예정이기 때문입니다.
2. **2025년 10월 15**일부터 새 Kinesis Data Analytics for SQL 애플리케이션을 생성할 수 없습니다.
3. **2026년 1월 27**일부터 애플리케이션이 삭제됩니다. Amazon Kinesis Data Analytics for SQL 애플리케이션을 시작하거나 작동할 수 없게 됩니다. 그 시점부터 Amazon Kinesis Data Analytics for SQL에 대한 지원을 더 이상 이용할 수 없습니다. 자세한 내용은 [Amazon Kinesis Data Analytics for SQL 애플리케이션 단종](discontinuation.md) 단원을 참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AddApplicationReferenceDataSource
**참고**
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오.
기존 애플리케이션에 준거 데이터 소스를 추가합니다.
Amazon Kinesis Analytics는 준거 데이터(즉, Amazon S3 객체)를 읽고 애플리케이션 내에 애플리케이션 내 표를 만듭니다. 요청에서 소스(S3 버킷 명칭과 객체 키 명칭), 생성할 애플리케이션 내 표의 명칭, Amazon S3 객체의 데이터가 결과 애플리케이션 내 표의 열에 매핑하는 방법을 설명하는 필요한 매핑 정보를 제공합니다.
개념 정보는 [애플리케이션 입력 구성](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)을 참조하십시오. 애플리케이션에 추가할 수 있는 데이터 소스에 대한 한도는 [한도](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)를 참조하십시오.
이 작업에는 `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](#API_AddApplicationReferenceDataSource_RequestSyntax) **
기존 애플리케이션의 명칭입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `[a-zA-Z0-9_.-]+`
필수 여부: 예
** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) **
준거 데이터 소스가 추가되는 애플리케이션의 버전입니다. [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 작업을 사용하여 최신 애플리케이션 버전을 받을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우 `ConcurrentModificationException`가 반환됩니다.
타입: Long
유효 범위: 최소값 1. 최대값 999999999.
필수 항목 여부: 예
** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) **
준거 데이터 소스는 Amazon S3 버킷의 객체일 수 있습니다. Amazon Kinesis Analytics는 객체를 읽고 생성된 애플리케이션 내 표에 데이터를 복사합니다. S3 버킷, 객체 키 명칭, 생성된 애플리케이션 내 표를 제공합니다. Amazon Kinesis Analytics가 사용자를 대신해 S3 버킷에서 객체를 읽기 위해 맡을 수 있는 IAM 역할도 제공해야 합니다.
타입: [ReferenceDataSource](API_ReferenceDataSource.md)객체
필수 여부: 예
## 응답 요소
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.
## 오류
** ConcurrentModificationException **
애플리케이션을 동시에 수정한 결과 예외가 발생했습니다. 예컨대, 두 사람이 동시에 같은 애플리케이션을 편집하려고 하는 경우를 예로 들 수 있습니다.
** message **
HTTP 상태 코드: 400
** InvalidArgumentException **
지정한 입력 파라미터 값이 유효하지 않습니다.
** message **
HTTP 상태 코드: 400
** ResourceInUseException **
이 작업을 위한 애플리케이션을 얻을 수 없습니다.
** message **
HTTP 상태 코드: 400
** ResourceNotFoundException **
지정된 애플리케이션을 찾을 수 없습니다.
** message **
HTTP 상태 코드: 400
** UnsupportedOperationException **
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)