EventDataBatch Třída

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