ServiceBusMessageBatch Clase

Un lote de mensajes.

El envío de mensajes en un lote es más eficaz que enviar mensajes individuales. ServiceBusMessageBatch le ayuda a crear el lote de tamaño máximo permitido de Message para mejorar el rendimiento del envío.

Use el método add para agregar mensajes hasta que se alcance el límite máximo de tamaño de lote en bytes, momento en el que se generará un messageSizeExceededError .

Use el método create_message_batch de ServiceBusSender para crear un objeto ServiceBusMessageBatch en lugar de crear instancias de un objeto ServiceBusMessageBatch directamente.

Herencia

builtins.object

ServiceBusMessageBatch

Constructor

ServiceBusMessageBatch(max_size_in_bytes: int | None = None, **kwargs: Any)

Parámetros

Nombre	Description
max_size_in_bytes	Optional[int] Tamaño máximo de los datos de bytes que puede contener un objeto ServiceBusMessageBatch. valor predeterminado: None

Métodos

add_message

Intente agregar un único mensaje al lote. El tamaño total de un mensaje agregado es la suma de su cuerpo, propiedades, etc. Si este tamaño agregado da como resultado que el lote supere el tamaño máximo del lote, se generará un messageSizeExceededError .

add_message

Intente agregar un único mensaje al lote.

El tamaño total de un mensaje agregado es la suma de su cuerpo, propiedades, etc. Si este tamaño agregado da como resultado que el lote supere el tamaño máximo del lote, se generará un messageSizeExceededError .

add_message(message: ServiceBusMessage | AmqpAnnotatedMessage | Mapping[str, Any]) -> None

Parámetros

Nombre	Description
message Requerido	Union[ServiceBusMessage, AmqpAnnotatedMessage] Mensaje que se va a agregar al lote.

Excepciones

Tipo	Description
<xref:azure.servicebus.exceptions.MessageSizeExceededError>, <xref:when exceeding the size limit.>

Atributos

max_size_in_bytes

Tamaño máximo de los datos de bytes que puede contener un objeto ServiceBusMessageBatch.

Devoluciones

Tipo	Description
int

message

Obtenga el uamqp subyacente. BatchMessage o LegacyBatchMessage. Esto está en desuso y se quitará en una versión posterior.

Devoluciones

Tipo	Description
<xref:uamqp.BatchMessage>, <xref:LegacyBatchMessage>

size_in_bytes

Tamaño combinado de los mensajes del lote, en bytes.

Devoluciones

Tipo	Description
int