기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AddApplicationReferenceDataSource
<a name="API_AddApplicationReferenceDataSource"></a>

기존 SQL 기반 Amazon Kinesis Data Analytics 애플리케이션에 참조 데이터 원본을 추가합니다.

Kinesis Data Analytics는 참조 데이터(즉, Amazon S3 객체)를 읽고 애플리케이션 내에 인애플리케이션 테이블을 만듭니다. 요청에서 소스(S3 버킷 이름과 객체 키 이름), 생성할 인애플리케이션 테이블의 이름, Amazon S3 객체의 데이터가 결과 인애플리케이션 테이블의 열에 매핑하는 방법을 설명하는 필요한 매핑 정보를 제공합니다.

## 구문 요청
<a name="API_AddApplicationReferenceDataSource_RequestSyntax"></a>

```
{
   "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"
   }
}
```

## 요청 파라미터
<a name="API_AddApplicationReferenceDataSource_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-request-ApplicationName"></a>
기존 애플리케이션의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이 128.  
패턴: `[a-zA-Z0-9_.-]+`   
필수 여부: 예

 ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-request-CurrentApplicationVersionId"></a>
참조 데이터 소스를 추가할 애플리케이션의 버전입니다. [DescribeApplication](API_DescribeApplication.md) 작업을 사용하여 현재 애플리케이션 버전을 가져올 수 있습니다. 지정한 버전이 현재 버전이 아닌 경우 `ConcurrentModificationException`이 반환됩니다.  
타입: Long  
유효 범위: 최소값 1. 최대값 999999999.  
필수 항목 여부: 예

 ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-request-ReferenceDataSource"></a>
준거 데이터 소스는 Amazon S3 버킷의 객체일 수 있습니다. Kinesis Data Analytics는 객체를 읽고 생성된 인애플리케이션 테이블에 데이터를 복사합니다. S3 버킷, 객체 키 명칭, 생성된 애플리케이션 내 표를 제공합니다.  
타입: [ReferenceDataSource](API_ReferenceDataSource.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_AddApplicationReferenceDataSource_ResponseSyntax"></a>

```
{
   "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"
      }
   ]
}
```

## 응답 요소
<a name="API_AddApplicationReferenceDataSource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ApplicationARN](#API_AddApplicationReferenceDataSource_ResponseSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-response-ApplicationARN"></a>
 애플리케이션 Amazon 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 2,048.  
패턴: `arn:.*` 

 ** [ApplicationVersionId](#API_AddApplicationReferenceDataSource_ResponseSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-response-ApplicationVersionId"></a>
업데이트된 애플리케이션 버전 ID입니다. Kinesis Data Analytics는 애플리케이션이 업데이트될 때이 ID를 증가시킵니다.  
타입: Long  
유효 범위: 최소값 1. 최대 값은 999999999입니다.

 ** [ReferenceDataSourceDescriptions](#API_AddApplicationReferenceDataSource_ResponseSyntax) **   <a name="APIReference-AddApplicationReferenceDataSource-response-ReferenceDataSourceDescriptions"></a>
애플리케이션에 대해 구성된 참조 데이터 소스에 대해 설명합니다.  
타입: [ReferenceDataSourceDescription](API_ReferenceDataSourceDescription.md) 객체 배열

## 오류
<a name="API_AddApplicationReferenceDataSource_Errors"></a>

 ** ConcurrentModificationException **   
애플리케이션의 동시 수정으로 인해 발생한 예외입니다. 이 오류는 현재 애플리케이션 ID를 사용하지 않고 애플리케이션을 수정하려고 시도한 경우 발생할 수 있습니다.  
HTTP 상태 코드: 400

 ** InvalidArgumentException **   
지정한 입력 파라미터 값이 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청 JSON이 작업에 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
이 작업에는 애플리케이션을 사용할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 애플리케이션을 찾을 수 없습니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_AddApplicationReferenceDataSource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/AddApplicationReferenceDataSource)