Guia de início rápido: enviar e receber mensagens grandes com os Hubs de Eventos do Azure (Visualização)

Neste guia de início rápido, você aprenderá a enviar e receber mensagens grandes (até 20 MB) usando os Hubs de Eventos do Azure. Se você é novo nos Hubs de Eventos do Azure, consulte Visão geral dos Hubs de Eventos antes de passar por este início rápido.

Pré-requisitos

Para concluir este Guia de início rápido, você precisa dos seguintes pré-requisitos:

• Subscrição do Microsoft Azure. Para usar os serviços do Azure, incluindo os Hubs de Eventos do Azure, você precisa de uma assinatura. Se você não tiver uma conta existente do Azure, poderá se inscrever para uma avaliação gratuita ou usar seus benefícios de assinante do MSDN ao criar uma conta.

• Crie um cluster dedicado escalável e de autoatendimento, hubs de eventos, namespace e um hub de eventos. A primeira etapa é usar o portal do Azure para criar um cluster dedicado e namespace dentro de um cluster. Para criar um hub de eventos, consulte Guia de início rápido: criar um hub de eventos usando o portal do Azure. Você pode pular esta etapa se já tiver um cluster dedicado escalável de autoatendimento.

Nota

O Suporte a Grandes Mensagens, atualmente em Visualização Pública, está disponível exclusivamente com determinados clusters dedicados de autoatendimento de Hubs de Eventos. O streaming de mensagens grandes com esses clusters não incorre em custos extras.

Configurando o cluster dedicado de Hubs de Eventos

Para transmitir mensagens grandes, você deve configurar seu cluster dedicado escalável de autoatendimento. Você pode seguir os passos abaixo:

• No portal do Azure, navegue até a seção 'Configurações' para Cluster dedicado e selecione a guia 'Cota' em Configurações.

• Valide se o valor para chave somente leitura suporta largemessages está definido como true.
• Você pode atualizar a chave: eventhubmaxmessagesizeinbytes para o valor adequado em bytes. O intervalo aceitável para esse valor está entre 1048576 e 20971520 bytes.

Depois que a configuração for salva, você estará pronto para transmitir mensagens grandes com hubs de eventos.

Importante

O streaming de mensagens grandes só é suportado com clusters dedicados escaláveis de autoatendimento construídos a partir da infraestrutura mais recente. Esse recurso é refletido pela tecla "Supportslargemessages". Se seu valor for false, o cluster não suportará streaming de mensagens grandes. Para habilitar esse recurso, você deve recriar o cluster.

Streaming de mensagens grandes com hubs de eventos do Azure

Os Hubs de Eventos do Azure permitem o streaming de mensagens grandes até 20 MB, tanto em lotes como como publicações individuais. Ser capaz de transmitir mensagens ou eventos grandes não requer alterações no código do cliente, além da alteração na mensagem ou evento em si. Você pode continuar enviando/recebendo mensagens usando qualquer SDK de hubs de eventos existente/Kafka API para transmitir mensagens grandes para o hub de eventos. Isso permite que você transmita mensagens grandes para o hub de eventos da mesma maneira que faria para mensagens de tamanho inferior a 1 MB. Saiba mais aqui

Gorjeta

Certifique-se de revisar qualquer configuração de cliente AMQP de Hubs de Eventos ou cliente Kafka que possa estar limitando o tamanho máximo de mensagem que você transmite para hubs de eventos. Você deve atualizar o tempo limite do cliente para um valor mais alto para poder transmitir mensagens grandes. Por padrão, a contagem de pré-busca do cliente AMQP é 300. Você deve reduzir esse valor para evitar problemas de memória do lado do cliente ao lidar com mensagens grandes.

Para obter referência completa da biblioteca .NET, consulte nossa documentação do SDK.