Bagikan melalui

EventDataBatch Kelas

  • Referensi

Batch peristiwa.

Mengirim peristiwa dalam batch lebih berkinerja daripada mengirim peristiwa individual. EventDataBatch membantu Anda membuat batch ukuran maksimum yang diizinkan dari EventData untuk meningkatkan performa pengiriman.

Gunakan metode tambahkan untuk menambahkan peristiwa hingga batas ukuran batch maksimum dalam byte telah tercapai - di mana ValueError akan dinaikkan. Gunakan metode EventHubProducerClientsend_batch atau asinkron EventHubProducerClient untuk mengirim.

Gunakan metode create_batch EventHubProducerClient untuk membuat objek EventDataBatch alih-alih membuat instans objek EventDataBatch secara langsung.

PERINGATAN: Memperbarui nilai variabel instans max_size_in_bytes pada objek EventDataBatch yang dibuat sangat TIDAK DIANJURKAN. Nilai max_size_in_bytes yang diperbarui dapat bertentangan dengan ukuran maksimum peristiwa yang diizinkan oleh layanan Azure Event Hubs dan mengakibatkan kegagalan pengiriman.

Warisan
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)

Parameter

Nama Deskripsi
max_size_in_bytes
int

Ukuran maksimum data byte yang dapat disimpan objek EventDataBatch.

nilai default: None
partition_id
str

ID partisi tertentu untuk dikirim.

nilai default: None
partition_key
str

Dengan partition_key yang diberikan, data peristiwa akan dikirim ke partisi tertentu dari Event Hub yang diputuskan oleh layanan.

nilai default: None

Metode

add

Coba tambahkan EventData ke batch.

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

add

Coba tambahkan EventData ke batch.

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

add(event_data: EventData | AmqpAnnotatedMessage) -> None

Parameter

Nama Deskripsi
event_data
Diperlukan
Union[EventData, AmqpAnnotatedMessage]

EventData untuk ditambahkan ke batch.

Mengembalikan

Jenis Deskripsi
None

Atribut

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 peristiwa dalam batch, dalam byte.

Mengembalikan

Jenis Deskripsi
int