애플리케이션 출력 구성 - Amazon Kinesis Data Analytics for SQL Applications 개발자 안내서
를 사용하여 출력 생성 AWS CLI

신중한 고려 끝에 두 단계로 Amazon Kinesis Data Analytics for SQL applications를 중단하기로 결정했습니다.

1. 2025년 10월 15일부터 SQL 애플리케이션을 위한 새 Kinesis Data Analytics를 생성할 수 없습니다.

2. 2026년 1월 27일부터 애플리케이션이 삭제됩니다. SQL 애플리케이션용 Amazon Kinesis Data Analytics를 시작하거나 작동할 수 없습니다. 해당 시점부터 에 대한 Amazon Kinesis Data AnalyticsSQL에 대한 지원을 더 이상 사용할 수 없습니다. 자세한 내용은 Amazon Kinesis Data Analytics for SQL Applications 중단 단원을 참조하십시오.

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

애플리케이션 출력 구성

애플리케이션 코드에서 SQL 명령문의 출력을 하나 이상의 애플리케이션 내 스트림에 씁니다. 선택적으로 애플리케이션에 출력 구성을 추가할 수 있습니다. 는 애플리케이션 내 스트림에 기록된 모든 내용을 Amazon Kinesis 데이터 스트림, Firehose 전송 스트림 또는 AWS Lambda 함수와 같은 외부 대상으로 유지할 수 있습니다.

애플리케이션 출력을 유지하는 데 사용할 수 있는 외부 대상의 수에는 제한이 있습니다. 자세한 설명은 Limits 섹션을 참조하십시오.

참고

오류를 조사할 수 있도록 하나의 외부 대상을 사용하여 애플리케이션 내 오류 스트림 데이터를 유지하는 것이 좋습니다.

이들 출력 구성 각각에 대해 다음을 제공합니다:

  • 애플리케이션 내 스트림 명칭 – 외부 목적지에 유지하고자 하는 스트림.

    Kinesis Data Analytics는 출력 구성에 지정된 애플리케이션 내 스트림을 탐색합니다. (이 스트림 명칭은 대/소문자를 구분하며 정확히 일치해야 합니다.) 애플리케이션 코드가 이 애플리케이션 내 스트림을 생성하는지 확인하십시오.

  • 외부 대상 - Kinesis 데이터 스트림, Firehose 전송 스트림 또는 Lambda 함수에 데이터를 유지할 수 있습니다. 스트림 또는 함수의 Amazon 리소스 이름(ARN)을 입력합니다. 또한 Kinesis Data Analytics가 사용자를 대신하여 스트림 또는 함수에 쓸 수 있는 IAM 역할을 제공합니다. 외부 대상에 쓸 때 사용할 레코드 형식(JSON, CSV)을 Kinesis Data Analytics에 설명합니다.

Kinesis Data Analytics가 스트리밍 또는 Lambda 목적지에 작성할 수 없을 경우에는 계속하여 무한정 시도합니다. 이로 인해 백 프레셔(back pressure)가 발생하여 애플리케이션이 뒤쳐지게 됩니다. 이 문제가 해결되지 않을 경우 결국 애플리케이션이 신규 데이터 처리를 중단합니다. Amazon Kinesis Data Analytics 지표를 모니터링하고 장애에 대한 경보를 설정할 수 있습니다. 지표 및 경보에 대한 자세한 내용은 Amazon CloudWatch 지표 사용 및 Amazon CloudWatch 경보 생성을 참조하세요.

AWS Management Console을(를) 사용하여 애플리케이션 출력을 구성할 수 있습니다. 콘솔이 구성을 저장하기 위해 API 호출합니다.

를 사용하여 출력 생성 AWS CLI

이 섹션에서는 CreateApplication 또는 AddApplicationOutput 작업에 대한 요청 본문의 Outputs 섹션을 생성하는 방법을 설명합니다.

Kinesis 스트림 출력 생성

다음 JSON 조각은 Amazon Kinesis 데이터 스트림 대상을 생성하기 위한 CreateApplication 요청 본문의 Outputs 섹션을 보여줍니다.

"Outputs": [
   {
       "DestinationSchema": {
           "RecordFormatType": "string"
       },
       "KinesisStreamsOutput": {
           "ResourceARN": "string",
           "RoleARN": "string"
       },
       "Name": "string"
   }
 
]

Firehose 전송 스트림 출력 생성

다음 JSON 조각은 Amazon Data Firehose 전송 스트림 대상을 생성하기 위한 CreateApplication 요청 본문의 Outputs 섹션을 보여줍니다.

"Outputs": [
   {
       "DestinationSchema": {
           "RecordFormatType": "string"
       },
       "KinesisFirehoseOutput": {
           "ResourceARN": "string",
           "RoleARN": "string"
       },
       "Name": "string"
   }
]

Lambda 함수 출력 생성

다음 JSON 조각은 AWS Lambda 함수 대상을 생성하기 위한 CreateApplication 요청 본문의 Outputs 섹션을 보여줍니다.

"Outputs": [
   {
       "DestinationSchema": {
           "RecordFormatType": "string"
       },
       "LambdaOutput": {
           "ResourceARN": "string",
           "RoleARN": "string"
       },
       "Name": "string"
   }
]