ServiceBusMessageBatch Třída

Dávka zpráv.

Odesílání zpráv v dávce je výkonnější než odesílání jednotlivých zpráv. ServiceBusMessageBatch pomáhá vytvořit maximální povolenou velikost dávky zprávy , aby se zlepšil výkon odesílání.

Pomocí metody add přidejte zprávy, dokud nebude dosaženo maximálního limitu velikosti dávky v bajtech – v tomto okamžiku bude vyvolána chyba MessageSizeExceededError .

Použijte metodu create_message_batch ServiceBusSender k vytvoření objektu ServiceBusMessageBatch místo vytvoření instance objektu ServiceBusMessageBatch přímo.

Dědičnost

builtins.object

ServiceBusMessageBatch

Konstruktor

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

Parametry

Name	Description
max_size_in_bytes	Optional[int] Maximální velikost bajtů dat, která může objekt ServiceBusMessageBatch obsahovat. Default value: None

Metody

add_message

Zkuste do dávky přidat jednu zprávu. Celková velikost přidané zprávy je součtem jejího textu, vlastností atd. Pokud tato přidaná velikost způsobí, že dávka překročí maximální velikost dávky, bude vyvolána Chyba MessageSizeExceededError .

add_message

Zkuste do dávky přidat jednu zprávu.

Celková velikost přidané zprávy je součtem jejího textu, vlastností atd. Pokud tato přidaná velikost způsobí, že dávka překročí maximální velikost dávky, bude vyvolána Chyba MessageSizeExceededError .

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

Parametry

Name	Description
message Vyžadováno	Union[ServiceBusMessage, AmqpAnnotatedMessage] Zpráva, která se má přidat do dávky.

Výjimky

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

Atributy

max_size_in_bytes

Maximální velikost bajtů dat, která může objekt ServiceBusMessageBatch obsahovat.

Návraty

Typ	Description
int

message

Získejte základní uamqp. BatchMessage nebo LegacyBatchMessage. Tato funkce je zastaralá a v pozdější verzi se odebere.

Návraty

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

size_in_bytes

Kombinovaná velikost zpráv v dávce v bajtech.

Návraty

Typ	Description
int