Guida introduttiva: Inviare e ricevere messaggi di grandi dimensioni con Hub eventi di Azure (anteprima)

  • Articolo

In questa guida introduttiva si apprenderà come inviare e ricevere messaggi di grandi dimensioni (fino a 20 MB) usando Hub eventi di Azure. Se non si ha familiarità con Hub eventi, vedere Panoramica di Hub eventi prima di passare a questa guida introduttiva.

Prerequisiti

Per completare questa guida introduttiva è necessario soddisfare i prerequisiti seguenti:

  • Una sottoscrizione di Azure. Per usare i servizi di Azure, inclusi Hub eventi, è necessaria una sottoscrizione. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita oppure usare i vantaggi della sottoscrizione di MSDN per la creazione di un account.
  • Un cluster dedicato self-service scalabile, uno spazio dei nomi di Hub eventi e un hub eventi. Il primo passaggio per soddisfare questo prerequisito consiste nell'usare il portale di Azure per creare un cluster dedicato e uno spazio dei nomi all'interno di un cluster. Per creare un hub eventi, vedere Avvio rapido: Creare un hub eventi usando il portale di Azure. È possibile ignorare questo passaggio se si dispone già di un cluster dedicato scalabile self-service.

Nota

Il supporto di messaggi di grandi dimensioni, attualmente in anteprima pubblica, è disponibile esclusivamente con alcuni cluster dedicati self-service di Hub eventi. Lo streaming di messaggi di grandi dimensioni con questi cluster non comporta costi aggiuntivi.

Configurare un cluster dedicato di Hub eventi

Per trasmettere messaggi di grandi dimensioni, è necessario configurare il cluster dedicato scalabile self-service.

Nella portale di Azure passare alla sezione Impostazioni per il cluster dedicato. In Impostazioni selezionare la scheda Quota .

Screenshot che mostra il riquadro Quota per un cluster dedicato.

  • Verificare che il valore per la chiave supportslargemessages di sola lettura sia impostato su True.
  • È possibile aggiornare la chiave eventhubmaxmessagesizeinbytes a un valore appropriato in byte. Un intervallo accettabile per questo valore è compreso tra 1.048.576 e 20.971.520 byte.

Dopo aver salvato la configurazione, è possibile trasmettere messaggi di grandi dimensioni con Hub eventi.

Importante

Lo streaming di messaggi di grandi dimensioni è supportato solo con cluster dedicati scalabili self-service creati dall'infrastruttura più recente. Questa funzionalità viene riflessa dalla Supportslargemessages chiave.

Se un valore del cluster è false, non supporterà lo streaming di messaggi di grandi dimensioni. Per abilitare questa funzionalità, è necessario ricreare il cluster.

Trasmettere messaggi di grandi dimensioni con Hub eventi

Hub eventi consente lo streaming di messaggi di grandi dimensioni fino a 20 MB, sia in batch che come singole pubblicazioni. La possibilità di trasmettere messaggi o eventi di grandi dimensioni non richiede modifiche al codice client a parte la modifica nel messaggio o nell'evento stesso. È possibile continuare a inviare o ricevere messaggi usando qualsiasi SDK di Hub eventi o API Kafka esistente per trasmettere messaggi di grandi dimensioni a Hub eventi. In questo modo è possibile trasmettere messaggi di grandi dimensioni a Hub eventi nello stesso modo in cui si farebbe per i messaggi di dimensioni inferiori a 1 MB.

Per altre informazioni, vedere Inviare e ricevere eventi da Hub eventi tramite .NET.

Suggerimento

Assicurarsi di esaminare qualsiasi client AMQP (Advanced Message Queuing Protocol) di Hub eventi o configurazione client Kafka che potrebbe limitare le dimensioni massime dei messaggi trasmessi in Hub eventi. È necessario aggiornare il timeout del client a un valore superiore per trasmettere messaggi di grandi dimensioni.

Per impostazione predefinita, il numero di prelettura client AMQP è 300. Ridurre questo valore per evitare problemi di memoria sul lato client quando si gestiscono messaggi di grandi dimensioni.

Per informazioni di riferimento complete sulla libreria .NET, vedere la documentazione dell'SDK.