ServiceBusMessageBatch Classe

Batch di messaggi.

L'invio di messaggi in un batch è più efficiente rispetto all'invio di singoli messaggi. ServiceBusMessageBatch consente di creare il batch di dimensioni massime consentite di Message per migliorare le prestazioni di invio.

Utilizzare il metodo add per aggiungere messaggi fino a quando non viene raggiunto il limite massimo di dimensioni batch in byte. A questo punto verrà generato un messageSizeExceededError .

Utilizzare il metodo create_message_batch di ServiceBusSender per creare un oggetto ServiceBusMessageBatch anziché creare direttamente un'istanza di un oggetto ServiceBusMessageBatch.

Ereditarietà

builtins.object

ServiceBusMessageBatch

Costruttore

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

Parametri

Nome	Descrizione
max_size_in_bytes	Optional[int] Dimensione massima dei dati in byte che un oggetto ServiceBusMessageBatch può contenere. valore predefinito: None

Metodi

add_message

Provare ad aggiungere un singolo messaggio al batch. La dimensione totale di un messaggio aggiunto è la somma del corpo, delle proprietà e così via. Se questa dimensione aggiunta comporta il superamento delle dimensioni massime del batch, verrà generato un messageSizeExceededError .

add_message

Provare ad aggiungere un singolo messaggio al batch.

La dimensione totale di un messaggio aggiunto è la somma del corpo, delle proprietà e così via. Se questa dimensione aggiunta comporta il superamento delle dimensioni massime del batch, verrà generato un messageSizeExceededError .

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

Parametri

Nome	Descrizione
message Necessario	Union[ServiceBusMessage, AmqpAnnotatedMessage] Messaggio da aggiungere al batch.

Eccezioni

Tipo	Descrizione
<xref:azure.servicebus.exceptions.MessageSizeExceededError>, <xref:when exceeding the size limit.>

Attributi

max_size_in_bytes

Dimensione massima dei dati in byte che un oggetto ServiceBusMessageBatch può contenere.

Restituisce

Tipo	Descrizione
int

message

Ottenere l'oggetto uamqp sottostante. BatchMessage o LegacyBatchMessage. Questa operazione è deprecata e verrà rimossa in una versione successiva.

Restituisce

Tipo	Descrizione
<xref:uamqp.BatchMessage>, <xref:LegacyBatchMessage>

size_in_bytes

Dimensione combinata dei messaggi nel batch, in byte.

Restituisce

Tipo	Descrizione
int