Inicio rápido: enviar y recibir mensajes de gran tamaño con Azure Event Hubs (versión preliminar)

  • Artículo

En este inicio rápido, aprenderá a enviar y recibir mensajes de gran tamaño (hasta 20 MB) mediante Azure Event Hubs. Si es la primera vez que usa Event Hubs, consulte la información general de Event Hubs antes de comenzar con este inicio rápido.

Requisitos previos

Para completar este tutorial de inicio rápido, debe cumplir los siguientes requisitos previos:

  • Suscripción a Azure. Para usar los servicios de Azure, entre los que se incluye Event Hubs, se necesita una suscripción. Si no se dispone de una cuenta de Azure, es posible registrarse para obtener una evaluación gratuita, o bien usar las ventajas que disfrutan los suscriptores MSDN al crear una cuenta.
  • Un clúster dedicado escalable de autoservicio, un espacio de nombres de Event Hubs y un centro de eventos. El primer paso para cumplir este requisito previo es usar Azure Portal para crear un clúster dedicado y un espacio de nombres dentro de un clúster. Para crear un centro de eventos, consulte Inicio rápido: crear un centro de eventos mediante Azure Portal. Puede omitir este paso si ya dispone de un clúster dedicado autoescalable.

Nota:

La compatibilidad con mensajes de gran tamaño, actualmente en fase de versión preliminar pública, está disponible exclusivamente con determinados clústeres dedicados de autoservicio de Event Hubs. El streaming de grandes mensajes con estos clústeres no incurre en cargos adicionales.

Configuración de un clúster dedicado de Event Hubs

Para hacer streaming de mensajes de gran tamaño, debe configurar su clústeres dedicado escalable de autoservicio.

En Azure Portal, vaya a la sección Configuración del clúster dedicado. En Configuración, seleccione la pestaña Cuota.

Captura de pantalla en la que se muestra el panel Cuota de un clúster dedicado.

  • Compruebe que el valor de la clave de solo lectura supportslargemessages está establecido en True.
  • Puede actualizar la clave eventhubmaxmessagesizeinbytes a un valor adecuado en bytes. Un rango aceptable para este valor está entre 1 048 576 y 20 971 520 bytes.

Una vez guardada la configuración, ya está todo listo para transmitir mensajes de gran tamaño con Event Hubs.

Importante

La transmisión de mensajes de gran tamaño solo se admite con clústeres dedicados escalables de autoservicio creados a partir de la infraestructura más reciente. Esta funcionalidad se refleja mediante la clave Supportslargemessages.

Si el valor de un clúster es false, no admitirá la transmisión de mensajes de gran tamaño. Para habilitar esta característica, debe volver a crear el clúster.

Transmisión de mensajes de gran tamaño con Event Hubs

Event Hubs permite transmitir mensajes de gran tamaño de hasta 20 MB, tanto en lotes como en publicaciones individuales. La capacidad de transmitir eventos o mensajes de gran tamaño no requiere cambios en el código del cliente, aparte del cambio en el mensaje o evento en sí. Puede seguir enviando o recibiendo mensajes utilizando cualquier SDK de Event Hubs o API de Kafka existente para transmitir mensajes de gran tamaño a Event Hubs. Esto le permite transmitir mensajes de gran tamaño a Event Hubs de la misma manera que lo haría para los mensajes de tamaño inferior a 1 MB.

Para obtener más información, consulte Envío y recepción de eventos a o desde Event Hubs mediante .NET.

Sugerencia

Asegúrese de revisar cualquier configuración de cliente de Advanced Message Queuing Protocol (AMQP) de Event Hubs o cliente de Kafka que pueda limitar el tamaño máximo del mensaje transmitido a Event Hubs. Debe actualizar el tiempo de espera del cliente a un valor mayor para transmitir mensajes de gran tamaño.

De forma predeterminada, el recuento de captura previas del cliente de AMQP es 300. Reduzca este valor para evitar problemas de memoria del lado cliente al gestionar mensajes de gran tamaño.

Para obtener la referencia completa de la biblioteca de .NET, consulte la documentación de SDK.