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

# Amazon Chime SDK 메시징에서 메시징 데이터 스트리밍
<a name="streaming-export"></a>

메시지 및 채널 이벤트와 같은 데이터를 스트림 형태로 수신하도록 `AppInstance`를 구성할 수 있습니다. 그러면 해당 데이터에 실시간으로 반응할 수 있습니다. 현재 Amazon Chime SDK 메시징은 Kinesis 스트림만 스트림 대상으로 허용합니다. 이 기능과 함께 Kinesis 스트림을 사용하려면 다음과 같은 사전 요구 사항이 충족되어야 합니다.
+ Kinesis 스트림은와 동일한 AWS 계정에 있어야 합니다`AppInstance`.
+ 스트림은 `AppInstance`와 동일한 리전에 있어야 합니다.
+ 스트림 이름에 `chime-messaging-`으로 시작하는 접두사가 있어야 합니다.
+ 샤드를 두 개 이상 구성해야 합니다. 각 샤드는 초당 최대 1MB의 데이터를 수신할 수 있으므로 스트림의 규모를 적절하게 조정하세요.
+ 서버 측 암호화(SSE)를 사용하도록 설정해야 합니다.

**Kinesis 스트림을 구성하려면**

1. 이전 섹션의 사전 요구 사항을 사용하여 Kinesis 스트림을 하나 이상 생성한 다음 ARN을 가져옵니다. 발신자가 Amazon Chime 권한 외에 Kinesis 권한을 가지고 있는지 확인합니다.

   다음 예제에서는 AWS CLI를 사용하여 두 개의 샤드가 있는 Kinesis 스트림을 생성하는 방법과 SSE를 활성화하는 방법을 보여줍니다.

   `aws kinesis create-stream --stream-name chime-messaging-unique-name --shard-count 2`

   `aws kinesis start-stream-encryption --stream-name chime-messaging-unique-name --encryption-type KMS --key-id "alias/aws/kinesis"`

1. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html) API를 직접 호출하여 스트리밍을 구성합니다.

   두 데이터 유형 중 하나 또는 둘 다를 구성할 수 있으며, 두 데이터 유형에 대해 동일한 스트림 또는 별도의 스트림을 선택할 수 있습니다.

   다음 예제에서는 AWS CLI를 사용하여 `ChannelMessage` 및 `Channel` 데이터 유형을 스트리밍`appinstance`하도록를 구성하는 방법을 보여줍니다.

   ```
   aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn app_instance_arn \
   --streaming-configurations DataType=ChannelMessage,ResourceArn=kinesis_data_stream_arn
   ```

   ```
   aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn app_instance_arn \
   --streaming-configurations DataType=Channel,ResourceArn=kinesis_data_stream_arn
   ```

   데이터 유형의 범위는 다음과 같습니다.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/chime-sdk/latest/dg/streaming-export.html)

1. 구성된 Kinesis 스트림에서 데이터 읽기를 시작합니다.
**참고**  
스트리밍을 구성하기 전에 전송된 모든 이벤트는 Kinesis 스트림으로 전송되지 않습니다.

**데이터 형식**  
키네시스는 `EventType` 및 `Payload` 필드가 포함된 JSON 형식의 레코드를 출력합니다. 페이로드 형식은 `EventType`에 따라 달라집니다. 다음 표에는 이벤트 유형과 해당 페이로드 형식이 나열되어 있습니다.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/chime-sdk/latest/dg/streaming-export.html)