EventDataBatch Třída

  • Reference

Dávka událostí.

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

Pomocí metody add přidejte události, dokud nebude dosaženo maximálního limitu velikosti dávky v bajtech – v tomto okamžiku bude vyvolána chyba ValueError . K odeslání použijte send_batch metodu EventHubProducerClient nebo async EventHubProducerClient .

K vytvoření objektu EventDataBatch místo přímé instance objektu EventDataBatch použijte metodu create_batch EventHubProducerClient.

UPOZORNĚNÍ: Aktualizace hodnoty proměnné instance max_size_in_bytes u objektu EventDataBatch s instancí se DŮRAZNĚ NEDOPORUČUJE. Aktualizovaná hodnota max_size_in_bytes může kolidovat s maximální velikostí událostí povolenou službou Event Hubs a způsobit selhání odesílání.

Dědičnost
builtins.object
EventDataBatch

Konstruktor

EventDataBatch(max_size_in_bytes: int | None = None, partition_id: str | None = None, partition_key: str | bytes | None = None, **kwargs: Any)

Parametry

Name Description
max_size_in_bytes
int

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

výchozí hodnota: None
partition_id
str

ID konkrétního oddílu, do který se má odeslat.

výchozí hodnota: None
partition_key
str

S danou partition_key se data událostí odesílají do konkrétního oddílu centra událostí, o které rozhoduje služba.

výchozí hodnota: None

Metody

add

Zkuste do dávky přidat EventData.

Celková velikost přidané události je součet jejího těla, vlastností atd. Pokud tato přidaná velikost způsobí, že dávka překročí maximální velikost dávky, vyvolá se chyba ValueError .

add

Zkuste do dávky přidat EventData.

Celková velikost přidané události je součet jejího těla, vlastností atd. Pokud tato přidaná velikost způsobí, že dávka překročí maximální velikost dávky, vyvolá se chyba ValueError .

add(event_data: EventData | AmqpAnnotatedMessage) -> None

Parametry

Name Description
event_data
Vyžadováno
Union[EventData, AmqpAnnotatedMessage]

EventData, která se má přidat do dávky.

Návraty

Typ Description
None

Atributy

message

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

Návraty

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

size_in_bytes

Souhrnná velikost událostí v dávce v bajtech.

Návraty

Typ Description
int