ServiceBusMessageBatch Sınıf

  • Başvuru

Bir grup ileti.

İletileri toplu olarak göndermek, tek tek ileti göndermekten daha yüksek performanslıdır. ServiceBusMessageBatch, gönderme performansını geliştirmek için İleti'nin izin verilen en büyük boyut toplu işlemini oluşturmanıza yardımcı olur.

Bayt cinsinden toplu iş boyutu üst sınırına ulaşılana kadar ileti eklemek için add yöntemini kullanın; bu noktada MessageSizeExceededError oluşturulur.

ServiceBusMessageBatch nesnesini doğrudan örneklemek yerine bir ServiceBusMessageBatch nesnesi oluşturmak için lütfen ServiceBusSender'ın create_message_batch yöntemini kullanın.

Devralma
builtins.object
ServiceBusMessageBatch

Oluşturucu

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

Parametreler

Name Description
max_size_in_bytes
Optional[int]

ServiceBusMessageBatch nesnesinin tutabileceği bayt verisi boyutu üst sınırı.

Default value: None

Yöntemler

add_message

Toplu iş için tek bir İleti eklemeyi deneyin.

Eklenen iletinin toplam boyutu, gövdesinin, özelliklerinin vb. toplamıdır. Bu eklenen boyut toplu iş boyutunun üst sınırını aşması durumunda MessageSizeExceededError oluşturulur.

add_message

Toplu iş için tek bir İleti eklemeyi deneyin.

Eklenen iletinin toplam boyutu, gövdesinin, özelliklerinin vb. toplamıdır. Bu eklenen boyut toplu iş boyutunun üst sınırını aşması durumunda MessageSizeExceededError oluşturulur.

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

Parametreler

Name Description
message
Gerekli
Union[ServiceBusMessage, AmqpAnnotatedMessage]

Toplu iş için eklenecek ileti.

Özel durumlar

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

Öznitelikler

max_size_in_bytes

ServiceBusMessageBatch nesnesinin tutabileceği bayt verisi boyutu üst sınırı.

Döndürülenler

Tür Description
int

message

Temel alınan uamqp'yi alın. BatchMessage veya LegacyBatchMessage. Bu kullanım dışıdır ve sonraki bir sürümde kaldırılacaktır.

Döndürülenler

Tür Description
<xref:uamqp.BatchMessage>,
<xref:LegacyBatchMessage>

size_in_bytes

Toplu işlemdeki iletilerin bayt cinsinden birleşik boyutu.

Döndürülenler

Tür Description
int