AddApplicationOutput - SQL애플리케이션용 Amazon Kinesis Data Analytics 개발자 가이드

새 프로젝트의 경우 애플리케이션용 Kinesis Data Analytics보다 Apache Flink Studio용 새로운 관리형 서비스를 사용하는 것이 좋습니다. SQL Managed Service for Apache Flink Studio는 사용 편의성과 고급 분석 기능을 결합하여 정교한 스트림 처리 애플리케이션을 몇 분 만에 구축할 수 있도록 합니다.

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

AddApplicationOutput

참고

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

Amazon Kinesis Analytics 애플리케이션에 외부 대상을 추가합니다.

Amazon Kinesis Analytics가 애플리케이션 내 애플리케이션 내 인애플리케이션 스트림의 데이터를 외부 대상 (예: Amazon Kinesis 스트림, Amazon Kinesis Firehose 전송 스트림 또는 AWS Lambda 함수) 으로 전송하도록 하려면 이 작업을 사용하여 관련 구성을 애플리케이션에 추가합니다. 애플리케이션에 대해 출력을 하나 이상 구성할 수 있습니다. 각 출력 구성은 애플리케이션 내 스트림과 외부 대상을 매핑합니다.

오류를 분석할 수 있도록 출력 구성 중 하나를 사용하여 애플리케이션 내 오류 스트림에서 외부 대상으로 데이터를 전송할 수 있습니다. 자세한 설명은 애플리케이션 출력(목적지) 이해 섹션을 참조하십시오.

이 작업을 사용한 스트리밍 소스 추가를 포함하여 모든 구성 업데이트 시 새로운 버전의 애플리케이션이 생성됩니다. DescribeApplication작업을 사용하여 현재 애플리케이션 버전을 찾을 수 있습니다.

구성할 수 있는 애플리케이션 입력 및 출력 수 제한은 제한을 참조하십시오.

이 작업에는 kinesisanalytics:AddApplicationOutput 조치를 수행할 권한이 요구됩니다.

구문 요청

{ "ApplicationName": "string", "CurrentApplicationVersionId": number, "Output": { "DestinationSchema": { "RecordFormatType": "string" }, "KinesisFirehoseOutput": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsOutput": { "ResourceARN": "string", "RoleARN": "string" }, "LambdaOutput": { "ResourceARN": "string", "RoleARN": "string" }, "Name": "string" } }

요청 파라미터

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

ApplicationName

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

유형: 문자열

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

패턴: [a-zA-Z0-9_.-]+

필수 사항 여부: Yes

CurrentApplicationVersionId

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

타입: Long

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

필수 여부: 예

Output

각각 출력 구성 하나를 설명하는 객체의 배열입니다. 출력 구성에서 인애플리케이션 스트림, 대상 (즉, Amazon Kinesis 스트림, Amazon Kinesis Firehose 전송 스트림 또는 AWS Lambda 함수) 의 이름을 지정하고 대상에 쓸 때 사용할 구성을 기록합니다.

유형: Output객체

필수 여부: 예

Response Elements

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

Errors

ConcurrentModificationException

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

HTTP 상태 코드: 400

InvalidArgumentException

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

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

UnsupportedOperationException

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

HTTP 상태 코드: 400

참고

AWS 언어별 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.