AddApplicationInputProcessingConfiguration - Amazon Kinesis Data Analytics for SQL 애플리케이션 개발자 안내서
구문 요청요청 파라미터응답 요소오류참고

신중한 고려 끝에 두 단계로 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 애플리케이션 단종 단원을 참조하십시오.

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

AddApplicationInputProcessingConfiguration

참고

이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 Amazon Kinesis Data Analytics API V2 설명서를 참조하십시오.

애플리케이션에 InputProcessingConfiguration을 추가합니다. 입력 프로세서는 애플리케이션의 SQL 코드가 실행되기 전에 입력 스트림에서 레코드를 전처리합니다. 현재 사용할 수 있는 유일한 입력 프로세서는 AWS Lambda입니다.

구문 요청

{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "InputId": "string",
   "InputProcessingConfiguration": { 
      "InputLambdaProcessor": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      }
   }
}

요청 파라미터

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

ApplicationName

입력 구성을 추가할 애플리케이션의 명칭.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이 128.

Pattern: [a-zA-Z0-9_.-]+

필수 여부: 예

CurrentApplicationVersionId

입력 구성을 추가할 애플리케이션의 버전. DescribeApplication 작업을 사용하여 최신 애플리케이션 버전을 찾을 수 있습니다. 지정된 버전이 최신 버전이 아닌 경우 ConcurrentModificationException가 반환됩니다.

타입: Long

유효 범위: 최소값 1. 최대값 999999999.

필수 여부: 예

InputId

입력 처리 구성을 추가할 입력 구성의 ID. DescribeApplication 작업을 사용하여 애플리케이션의 입력 ID 목록을 가져올 수 있습니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 50.

Pattern: [a-zA-Z0-9_.-]+

필수 여부: 예

InputProcessingConfiguration

애플리케이션에 추가할 InputProcessingConfiguration.

유형: InputProcessingConfiguration 객체

필수 여부: 예

응답 요소

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

오류

ConcurrentModificationException

애플리케이션을 동시에 수정한 결과 예외가 발생했습니다. 예컨대, 두 사람이 동시에 같은 애플리케이션을 편집하려고 하는 경우를 예로 들 수 있습니다.

HTTP 상태 코드: 400

InvalidArgumentException

지정한 입력 파라미터 값이 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceInUseException

이 작업을 위한 애플리케이션을 얻을 수 없습니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정된 애플리케이션을 찾을 수 없습니다.

HTTP 상태 코드: 400

UnsupportedOperationException

지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDKs