Questo documento illustra come pubblicare messaggi in un argomento con uno schema.
Prima di iniziare
Prima di configurare il flusso di lavoro di pubblicazione, assicurati di aver completato le seguenti attività:
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 a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Per creare o aggiornare argomenti e iscrizioni, sono necessarie autorizzazioni aggiuntive.Pubblicare messaggi con schema
Puoi pubblicare messaggi in un argomento associato a uno schema. Devi codificare i messaggi nello schema e nel formato specificati quando hai creato l'argomento. Un messaggio corrisponde allo schema associato all'argomento se corrisponde a una delle revisioni dello schema nell'intervallo di revisioni consentito. I messaggi vengono valutati in base alle revisioni nell'ordine dalla revisione consentita più recente fino a quando non viene trovata una corrispondenza o non viene raggiunta la revisione consentita più vecchia. Pub/Sub aggiunge i seguenti attributi a un messaggio pubblicato correttamente in un argomento associato a uno schema:
googclient_schemaname
: il nome dello schema utilizzato per la convalida.googclient_schemaencoding
: la codifica del messaggio, JSON o BINARY.googclient_schemarevisionid
: l'ID revisione dello schema utilizzato per analizzare e convalidare il messaggio. A ogni revisione è associato un ID revisione univoco. L'ID revisione è un UUID di otto caratteri generato automaticamente.
Quando un messaggio non corrisponde a nessuna delle revisioni dello schema consentite dall'argomento, Pub/Sub restituisce un errore INVALID_ARGUMENT
alla richiesta di pubblicazione.
Pub/Sub valuta i messaggi in base alle revisioni dello schema solo al momento della pubblicazione. L'commit di una nuova revisione dello schema o la modifica dello schema associato a un argomento dopo la pubblicazione di un messaggio non ne comporta la rivalutazione né modifica alcuno degli attributi del messaggio dello schema allegato.
Puoi pubblicare messaggi in un argomento con uno schema associato in un progetto Google Cloud utilizzando la console Google Cloud, la gcloud CLI, l'API Pub/Sub o le librerie client di Cloud.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Pubblica un messaggio di esempio utilizzando il comando gcloud pubsub topics publish.
gcloud pubsub topics publish TOPIC_ID \ --message=MESSAGE
Sostituisci quanto segue:
TOPIC_ID: il nome dell'argomento che hai già creato.
MESSAGE: messaggio pubblicato nell'argomento. Un messaggio di esempio può essere
{"name": "Alaska", "post_abbr": "AK"}
.
C++
Prima di provare questo esempio, segui le istruzioni di configurazione C++ riportate nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub C++.
Avro ProtoC#
Prima di provare questo esempio, segui le istruzioni di configurazione C# riportate nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub C#.
Avro ProtoVai
Prima di provare questo esempio, segui le istruzioni di configurazione di Go riportate nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub Go.
Avro ProtoJava
Prima di provare questo esempio, segui le istruzioni di configurazione di Java riportate nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java Pub/Sub.
Avro ProtoNode.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js riportate nella Guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub Node.js.
Avro Protocol BufferNode.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js riportate nella Guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub Node.js.
Avro Protocol BufferPHP
Prima di provare questo esempio, segui le istruzioni di configurazione di PHP riportate nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP Pub/Sub.
Avro Protocol BufferPython
Prima di provare questo esempio, segui le istruzioni di configurazione di Python riportate nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub per Python.
Avro Protocol BufferRuby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby riportate nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby Pub/Sub.
Avro Protocol BufferPassaggi successivi
Per limitare le località in cui Pub/Sub archivia i dati dei messaggi, consulta Limitare le località delle risorse Pub/Sub.
Per scoprire di più sulla ricezione dei messaggi, consulta Scegliere un tipo di abbonamento.