Início Rápido: Enviar e receber mensagens grandes com os Hubs de Eventos do Azure (versão prévia)
Nesse início rápido, você aprenderá a enviar e receber mensagens grandes (até 20 MB) usando os Hubs de Eventos do Azure. Se você for novato nos Hubs de Eventos do Azure, confira o artigo Visão geral de Hubs de Eventos antes de fazer esse início rápido.
Pré-requisitos
Para concluir este início rápido, você precisará dos seguintes pré-requisitos:
- Uma assinatura do Azure. Para usar os serviços do Azure, incluindo os Hubs de Eventos, você precisa ter uma assinatura. Caso não tenha uma conta existente do Azure, inscreva-se em uma avaliação gratuita ou use os benefícios do assinante do MSDN quando criar uma conta.
- Um cluster de autoatendimento dedicado ampliável, um namespace de hubs de eventos e um hub de eventos. A primeira etapa quando se trata de cumprir esse pré-requisito é usar o portal do Azure para criar um namespace e um cluster dedicado dentro de um cluster. Para criar um hub de eventos, consulte Início Rápido: Criar um hub de eventos por meio do portal do Azure. Você pode ignorar esta etapa se já tiver um cluster dedicado escalonável de autoatendimento.
Observação
O suporte a mensagens grandes, atualmente em visualização pública, está disponível exclusivamente com determinados clusters de autoatendimento dedicados dos Hubs de Eventos. Transmitir mensagens grandes com esses clusters não incorre em encargos adicionais.
Configurar um cluster dedicado de Hubs de Eventos
Para transmitir mensagens grandes, você deve configurar seu cluster dedicado escaloná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
supportslargemessagessomente leitura está definido comoTrue. - Você pode atualizar a chave
eventhubmaxmessagesizeinbytespara um valor adequado em bytes. Um intervalo aceitável para esse valor está entre 1.048.576 e 20.971.520 bytes.
Após a configuração ser salva, você estará pronto para transmitir mensagens grandes com Hubs de Eventos.
Importante
A transmissão de mensagens grandes só tem suporte com clusters de autoatendimento dedicados ampliáveis criados com base na infraestrutura mais recente. Essa funcionalidade é refletida pela chave Supportslargemessages.
O cluster não terá suporte para a transmissão de mensagens grandes se o valor da chave for false. Para habilitar esse recurso, você precisa recriar o cluster.
Transmitir mensagens grandes com Hubs de Eventos
Os Hubs de Eventos permitem a transmissão de mensagens grandes de até 20 MB, tanto em lotes como em publicações individuais. A capacidade de transmitir eventos ou mensagens grandes não requer nenhuma alteração de código do cliente além da alteração na própria mensagem ou evento. Você pode continuar enviando ou recebendo mensagens com o uso de qualquer SDK de Hubs de Eventos ou API do Kafka existentes para transmitir mensagens grandes para Hubs de Eventos. Assim, você pode transmitir mensagens grandes para Hubs de Eventos da mesma maneira que o faria para mensagens de tamanhos inferiores a 1 MB.
Para obter mais informações, confira Receber e enviar eventos de e para Hubs de Eventos usando .NET.
Dica
Certifique-se de rever qualquer cliente do Advanced Message Queuing Protocol (AMQP) ou a configuração do cliente do Kafka que talvez limitem o tamanho máximo da mensagem que você transmitirá para os Hubs de Eventos. Você precisa atualizar o tempo limite do cliente para um valor mais alto para transmitir mensagens grandes.
Por padrão, o número da busca prévia do cliente AMQP é 300. Reduza esse valor para evitar problemas de memória do lado do cliente ao lidar com mensagens grandes.
Para obter uma referência completa da biblioteca .NET, confira a documentação do SDK.