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

En este inicio rápido, aprenderá a enviar y recibir mensajes de gran tamaño (hasta 20 MB) mediante Azure Event Hubs. Si no está familiarizado con Event Hubs, consulte Introducción a Event Hubs antes de empezar.

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 tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita o activar los créditos mensuales de Azure para suscriptores de Visual Studio.
• Un clúster dedicado escalable de autoservicio, un espacio de nombres de Event Hubs y un centro de eventos. Use 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 grandes se encuentra actualmente en 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.

• 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.
• Compruebe que el valor de la clave de solo lectura supportslargemessages está establecido en True.

Después de guardar la configuración, está listo para transmitir mensajes grandes 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. La Supportslargemessages clave refleja esta funcionalidad.

Si un valor de clúster es false, no admite el streaming 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 mediante cualquier SDK de Event Hubs o la API de Kafka existentes 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 del SDK, consulte Bibliotecas de Azure Event Hubs para .NET.