Partilhar via

ServiceBusMessageBatch Classe

  • Referência

Um lote de mensagens.

O envio de mensagens num lote é mais eficaz do que o envio de mensagens individuais. ServiceBusMessageBatch ajuda-o a criar o lote de tamanho máximo permitido da Mensagem para melhorar o desempenho de envio.

Utilize o método add para adicionar mensagens até que seja atingido o limite máximo de tamanho de lote em bytes, altura em que será gerado um MessageSizeExceededError .

Utilize o método create_message_batch do ServiceBusSender para criar um objeto ServiceBusMessageBatch em vez de instanciar diretamente um objeto ServiceBusMessageBatch.

Herança
builtins.object
ServiceBusMessageBatch

Construtor

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

Parâmetros

Name Description
max_size_in_bytes
Optional[int]

O tamanho máximo dos dados de bytes que um objeto ServiceBusMessageBatch pode conter.

Default value: None

Métodos

add_message

Tente adicionar uma única Mensagem ao lote.

O tamanho total de uma mensagem adicionada é a soma do respetivo corpo, propriedades, etc. Se este tamanho adicionado resultar em que o lote exceda o tamanho máximo do lote, será gerado um MessageSizeExceededError .

add_message

Tente adicionar uma única Mensagem ao lote.

O tamanho total de uma mensagem adicionada é a soma do respetivo corpo, propriedades, etc. Se este tamanho adicionado resultar em que o lote exceda o tamanho máximo do lote, será gerado um MessageSizeExceededError .

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

Parâmetros

Name Description
message
Necessário
Union[ServiceBusMessage, AmqpAnnotatedMessage]

A Mensagem a adicionar ao lote.

Exceções

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

Atributos

max_size_in_bytes

O tamanho máximo dos dados de bytes que um objeto ServiceBusMessageBatch pode conter.

Devoluções

Tipo Description
int

message

Obtenha o uamqp subjacente. BatchMessage ou LegacyBatchMessage. Esta ação foi preterida e será removida numa versão posterior.

Devoluções

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

size_in_bytes

O tamanho combinado das mensagens no lote, em bytes.

Devoluções

Tipo Description
int