Questo documento fornisce una panoramica sulla pubblicazione dei messaggi.
Pubblica flusso di lavoro del messaggio
Per pubblicare un messaggio con Pub/Sub, un'applicazione del publisher crea e invia messaggi a un argomento.
- Crea un messaggio contenente i tuoi dati.
- Seleziona eventuali attributi di pubblicazione facoltativi.
- Invia una richiesta al server Pub/Sub per pubblicare il messaggio in un argomento specificato.
Il servizio Pub/Sub riceve il messaggio e lo elabora come segue:
Il messaggio viene archiviato per la distribuzione.
Il messaggio viene replicato in più zone per garantire durabilità e disponibilità elevata.
Pub/Sub identifica i sottoscrittori le cui sottoscrizioni corrispondono all'argomento del messaggio e invia a ciascuno una copia del messaggio.
Pub/Sub offre la consegna di messaggi almeno una volta e l'ordinamento "best effort" ai sottoscrittori esistenti.
Per una panoramica sul sistema Pub/Sub, consulta la panoramica del servizio Pub/Sub.
Per una spiegazione del funzionamento di Pub/Sub, consulta Panoramica dell'architettura di Pub/Sub.
Informazioni sugli argomenti
Un argomento Pub/Sub è una risorsa denominata che rappresenta un feed di messaggi. Quando un publisher invia un messaggio, ha come target un argomento specifico. Il servizio Pub/Sub utilizza questo nome di argomento per instradare il messaggio a tutte le sottoscrizioni collegate all'argomento. Se ci sono più sottoscrittori di un abbonamento, solo un sottoscrittore della sottoscrizione riceverà il messaggio.
Gli editori non devono necessariamente conoscere il numero di iscritti. Si concentrano sull'argomento, assicurando la separazione dei problemi tra invio e ricezione dei messaggi.
Replica dei dati in un argomento
Un argomento Pub/Sub utilizza tre zone per archiviare i dati. Il servizio supporta la replica sincrona in almeno due zone e la replica secondo il criterio del "best effort" in una terza zona aggiuntiva. La replica Pub/Sub è all'interno di una sola regione.
Proprietà di un argomento
Quando crei o aggiorni un argomento, puoi specificare le proprietà dell'argomento.
Informazioni sui messaggi
Un messaggio Pub/Sub è costituito dai dati che si spostano attraverso il servizio.
Un messaggio è costituito da campi contenenti i dati e i metadati del messaggio. Uno dei seguenti deve essere specificato in un messaggio.
Dati del messaggio: sono i contenuti principali del messaggio e possono essere qualsiasi dato di testo o binario. Rappresenta le informazioni effettive che vuoi comunicare tra editori e abbonati. Se utilizzi direttamente l'API REST, i dati del messaggio devono essere codificati in base64. Vedi l'esempio nella scheda REST nella sezione Pubblica messaggi.
Una chiave di ordinamento: si tratta di un identificatore che rappresenta l'entità per la quale devono essere ordinati i messaggi. I messaggi con la stessa chiave di ordinamento devono essere recapitati a un sottoscrittore nell'ordine in cui sono stati pubblicati. La chiave di ordinazione è necessaria solo se vuoi la consegna ordinata dei tuoi messaggi. Per scoprire di più sull'ordinamento delle chiavi, consulta la pagina Messaggio di ordine.
Attributi: sono coppie chiave-valore facoltative che forniscono ulteriore contesto e informazioni sul messaggio. possono essere usate per il routing, l'applicazione di filtri o l'arricchimento dei contenuti. Ad esempio, potresti aggiungere attributi come timestamp o ID transazione. Per saperne di più sugli attributi utilizzati nella pubblicazione dei messaggi, vedi Utilizzare gli attributi per pubblicare un messaggio.
Il servizio Pub/Sub aggiunge i seguenti campi al messaggio:
- Un ID messaggio univoco per l'argomento
- Un timestamp che indica quando il servizio Pub/Sub riceve il messaggio
Ad esempio, ecco un formato di messaggio in JSON:
{
"data": "This is the core message content.",
"attributes": {
"category": "notification",
"user_id": "12345",
"priority": "medium"
},
"orderingKey": "12345"
}