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

# 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`에 따라 달라집니다. 다음 표에는 이벤트 유형과 해당 페이로드 형식이 나열되어 있습니다.


<table>
<thead>
  <tr><th>EventType</th><th>페이로드 형식</th><th></th></tr>
</thead>
<tbody>
  <tr><td>`CREATE_CHANNEL_MESSAGE`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html) </td><td></td></tr>
  <tr><td>`REDACT_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html) </td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_EXPIRATION_SETTINGS`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MEMBERSHIP`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MEMBERSHIP`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_BAN`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_BAN`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MODERATOR`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MODERATOR`</td><td></td></tr>
  <tr><td>`CREATE_SUB_CHANNEL`</td><td rowspan="2">[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax)<br />[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId)</td><td></td></tr>
  <tr><td>`DELETE_SUB_CHANNEL`</td><td></td></tr>
</tbody>
</table>