La messaggistica batch crea un client editore con impostazioni di batch personalizzate e lo utilizza per pubblicare alcuni messaggi.
Questo documento fornisce informazioni sull'utilizzo della messaggistica batch con i messaggi pubblicati in un argomento.
Prima di iniziare
Prima di configurare il flusso di lavoro di pubblicazione, assicurati di aver completato le seguenti attività:
- Scopri di più sugli argomenti e sul flusso di lavoro di pubblicazione.
- Crea un argomento.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per pubblicare messaggi in un argomento,
chiedi all'amministratore di concederti il ruolo IAM
Publisher Pub/Sub (roles/pubsub.publisher
) per l'argomento.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Devi disporre di autorizzazioni aggiuntive per creare o aggiornare argomenti e sottoscrizioni.
Utilizzare la messaggistica batch
Consulta i seguenti esempi di codice per scoprire come configurare le impostazioni di messaggistica batch per il tuo publisher.
C++
Prima di provare questo esempio, segui le istruzioni di configurazione di C++ riportate nella Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ Pub/Sub.
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Pub/Sub.
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go Pub/Sub.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java in Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java Pub/Sub.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js in Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js Pub/Sub.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js in Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js Pub/Sub.
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione PHP nella Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP Pub/Sub.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python in Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python Pub/Sub.
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby riportate in Guida rapida sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby Pub/Sub.
Disattiva messaggistica batch
Per disattivare il raggruppamento in batch nella libreria client, imposta il valore di max_messages
su 1.
Messaggistica collettiva e consegna degli ordini
Con la consegna ordinata, la mancata conferma di un messaggio nel batch significa che tutti i messaggi nel batch, inclusi quelli inviati prima del messaggio non confermato, vengono tutti nuovamente recapitati.
Quote e limiti per la messaggistica batch
Prima di configurare la messaggistica batch, considera l'effetto di fattori quali la quota di velocità effettiva di pubblicazione e la dimensione massima di un batch. Le librerie client di alto livello assicurano che le richieste batch vengano mantenute entro i limiti specificati.
- 1000 byte è la dimensione minima della richiesta considerata ai fini dei costi, anche se la dimensione effettiva del messaggio potrebbe essere inferiore a 1000 byte.
- Pub/Sub ha un limite di 10 MB o un numero di 1000 messaggi per una singola richiesta di pubblicazione batch.
Per maggiori informazioni, consulta Quote e limiti di Pub/Sub.
Passaggi successivi
Per scoprire come configurare le opzioni di pubblicazione avanzate, vedi quanto segue: