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 em Hubs de Eventos, consulte Visão geral dos Hubs de Eventos antes de passar por este início rápido.

Pré-requisitos

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

• Uma subscrição do Azure. Para usar os serviços do Azure, incluindo Hubs de Eventos, 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.
• Um cluster dedicado escalável de autoatendimento, um namespace de hubs de eventos e um hub de eventos. A primeira etapa para atender a esse pré-requisito é usar o portal do Azure para criar um cluster dedicado e um 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 mensagens grandes, 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.

Configurar um cluster dedicado de Hubs de Eventos

Para transmitir mensagens grandes, você deve configurar seu cluster dedicado escalável de autoatendimento.

No portal do Azure, vá para a seção Configurações do cluster dedicado. Em Configurações, selecione a guia Cota .

• Valide se o valor da chave supportslargemessages somente leitura está definido como True.
• Você pode atualizar a chave eventhubmaxmessagesizeinbytes para um valor adequado em bytes. Um intervalo aceitável para esse valor está entre 1.048.576 e 20.971.520 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 criados a partir da infraestrutura mais recente. Essa capacidade é refletida Supportslargemessages pela chave.

Se um valor de cluster for false, ele não suportará streaming de mensagens grandes. Para habilitar esse recurso, você deve recriar o cluster.

Transmita mensagens grandes com Hubs de Eventos

Os Hubs de Eventos permitem o streaming de mensagens grandes até 20 MB, tanto em lotes como em publicações individuais. A capacidade 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 ou recebendo mensagens usando qualquer SDK de Hubs de Eventos ou API Kafka existente para transmitir mensagens grandes para Hubs de Eventos. Dessa forma, você pode transmitir mensagens grandes para Hubs de Eventos da mesma maneira que faria para mensagens de tamanhos inferiores a 1 MB.

Para obter mais informações, consulte Enviar e receber eventos de Hubs de Eventos usando o .NET.

Gorjeta

Certifique-se de revisar qualquer cliente AMQP (Advanced Message Queuing Protocol) de Hubs de Eventos ou configuração de cliente Kafka que possa limitar 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 transmitir mensagens grandes.

Por padrão, a contagem de pré-busca do cliente AMQP é 300. Diminua esse valor para evitar problemas de memória do lado do cliente ao lidar com mensagens grandes.

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