ServiceBusMessageBatch Kelas

Kumpulan pesan.

Mengirim pesan dalam batch lebih berkinerja daripada mengirim pesan individual. ServiceBusMessageBatch membantu Anda membuat batch ukuran Pesan maksimum yang diizinkan untuk meningkatkan performa pengiriman.

Gunakan metode tambahkan untuk menambahkan pesan hingga batas ukuran batch maksimum dalam byte telah tercapai - di mana MessageSizeExceededError akan dinaikkan.

Gunakan metode create_message_batch ServiceBusSender untuk membuat objek ServiceBusMessageBatch alih-alih membuat instans objek ServiceBusMessageBatch secara langsung.

Warisan

builtins.object

ServiceBusMessageBatch

Konstruktor

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

Parameter

Nama	Deskripsi
max_size_in_bytes	Optional[int] Ukuran maksimum data byte yang dapat disimpan objek ServiceBusMessageBatch. nilai default: None

Metode

add_message

Cobalah untuk menambahkan satu Pesan ke batch. Ukuran total pesan yang ditambahkan adalah jumlah isi, properti, dll. Jika ukuran tambahan ini menghasilkan batch yang melebihi ukuran batch maksimum, MessageSizeExceededError akan dinaikkan.

add_message

Cobalah untuk menambahkan satu Pesan ke batch.

Ukuran total pesan yang ditambahkan adalah jumlah isi, properti, dll. Jika ukuran tambahan ini menghasilkan batch yang melebihi ukuran batch maksimum, MessageSizeExceededError akan dinaikkan.

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

Parameter

Nama	Deskripsi
message Diperlukan	Union[ServiceBusMessage, AmqpAnnotatedMessage] Pesan yang akan ditambahkan ke batch.

Pengecualian

Jenis	Deskripsi
<xref:azure.servicebus.exceptions.MessageSizeExceededError>, <xref:when exceeding the size limit.>

Atribut

max_size_in_bytes

Ukuran maksimum data byte yang dapat disimpan objek ServiceBusMessageBatch.

Mengembalikan

Jenis	Deskripsi
int

message

Dapatkan uamqp yang mendasar. BatchMessage atau LegacyBatchMessage. Ini tidak digunakan lagi dan akan dihapus dalam rilis selanjutnya.

Mengembalikan

Jenis	Deskripsi
<xref:uamqp.BatchMessage>, <xref:LegacyBatchMessage>

size_in_bytes

Ukuran gabungan pesan dalam batch, dalam byte.

Mengembalikan

Jenis	Deskripsi
int