빠른 시작: Azure Event Hubs를 사용하여 대용량 메시지 보내기 및 받기(미리 보기)

이 빠른 시작에서는 Azure Event Hubs를 사용하여 큰 메시지(최대 20MB)를 보내고 받는 방법을 알아봅니다. Event Hubs를 접하는 경우 이 빠른 시작을 진행하기 전에 Event Hubs 개요를 참조하세요.

필수 조건

이 빠른 시작을 완료하려면 다음 필수 구성 요소가 필요합니다.

• Azure 구독 Event Hubs를 비롯한 Azure 서비스를 사용하려면 구독이 필요합니다. 기존 Azure 계정이 없는 경우 평가판에 가입하거나 계정을 만들 때 MSDN 구독자 혜택을 사용할 수 있습니다.
• 셀프 서비스 확장 가능한 전용 클러스터, Event Hubs 네임스페이스 및 이벤트 허브. 이 필수 구성 요소를 충족하는 첫 번째 단계는 Azure Portal을 사용하여 클러스터 내에 전용 클러스터 및 네임스페이스를 만드는 것입니다. 이벤트 허브를 만들려면 빠른 시작: Azure Portal을 사용하여 이벤트 허브 만들기를 참조하세요. 스케일링 가능한 셀프서비스 전용 클러스터가 이미 있는 경우 이 단계를 건너뛸 수 있습니다.

참고 항목

현재 공개 미리 보기로 제공되는 대규모 메시지 지원은 특정 Event Hubs 셀프 서비스 전용 클러스터에서만 사용할 수 있습니다. 이러한 클러스터를 사용하여 대용량 메시지를 스트리밍하면 추가 요금이 발생하지 않습니다.

Event Hubs 전용 클러스터 구성

대용량 메시지를 스트리밍하려면 셀프서비스 스케일링 가능한 전용 클러스터를 구성해야 합니다.

Azure Portal에서 전용 클러스터의 설정 섹션으로 이동합니다. 설정에서 할당량 탭을 선택합니다.

• 읽기 전용 키 supportslargemessages 의 값이 .로 설정되어 있는지 확인합니다 True.
• 키를 eventhubmaxmessagesizeinbytes 적절한 값(바이트)으로 업데이트할 수 있습니다. 이 값에 허용되는 범위는 1,048,576에서 20,971,520바이트 사이입니다.

구성이 저장되면 Event Hubs를 사용하여 큰 메시지를 스트리밍할 준비가 된 것입니다.

Important

대형 메시지 스트리밍은 최신 인프라에서 구축된 자체 서비스 확장성 있는 전용 클러스터에서만 지원됩니다. 이 기능은 키에 의해 반영됩니다 Supportslargemessages .

클러스터 값이 false이면 큰 메시지 스트리밍을 지원하지 않습니다. 이 기능을 사용하려면 클러스터를 다시 만들어야 합니다.

Event Hubs를 사용하여 대용량 메시지 스트리밍

Event Hubs를 사용하면 일괄 처리 및 개별 게시로 최대 20MB의 큰 메시지를 스트리밍할 수 있습니다. 큰 메시지 또는 이벤트를 스트리밍하는 기능을 사용하려면 메시지 또는 이벤트 자체의 변경과 별도로 클라이언트 코드 변경이 필요하지 않습니다. 기존 Event Hubs SDK 또는 Kafka API를 사용하여 Event Hubs에 큰 메시지를 스트리밍하여 메시지를 계속 보내거나 받을 수 있습니다. 이렇게 하면 크기가 1MB 미만인 메시지와 동일한 방식으로 Event Hubs에 큰 메시지를 스트리밍할 수 있습니다.

자세한 내용은 .NET을 사용하여 Event Hubs에 이벤트 보내기 및 받기를 참조하세요.

팁

Event Hubs로 스트리밍하는 최대 메시지 크기를 제한할 수 있는 AMQP(Event Hubs 고급 메시지 큐 프로토콜) 클라이언트 또는 Kafka 클라이언트 구성을 검토해야 합니다. 큰 메시지를 스트리밍하려면 클라이언트 시간 제한을 더 높은 값으로 업데이트해야 합니다.

기본적으로 AMQP 클라이언트 프리페치 수는 300개입니다. 대용량 메시지를 처리할 때 클라이언트 쪽 메모리 문제를 방지하려면 이 값을 낮춥다.

전체 .NET 라이브러리 참조는 SDK 설명서를 참조 하세요.