Questo documento mostra come creare schemi per gli argomenti Pub/Sub.
Prima di iniziare
Prima di creare uno schema, completa quanto segue:
- Scopri di più sugli argomenti e sul flusso di lavoro di pubblicazione.
- Scopri come funzionano gli schemi Pub/Sub.
- Crea un argomento.
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni necessarie per creare e gestire gli schemi,
chiedi all'amministratore di concederti il ruolo IAM Editor Pub/Sub (roles/pubsub.editor
) nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire gli schemi. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per creare e gestire gli schemi sono necessarie le seguenti autorizzazioni:
-
Crea schema:
pubsub.schemas.create
-
Allega lo schema all'argomento:
pubsub.schemas.attach
-
Esegui il commit di una revisione dello schema:
pubsub.schemas.commit
-
Elimina uno schema o una revisione dello schema:
pubsub.schemas.delete
-
Ottieni uno schema o le revisioni dello schema:
pubsub.schemas.get
-
Elenca schemi:
pubsub.schemas.list
-
Revisioni dello schema dell'elenco:
pubsub.schemas.listRevisions
-
Esegui il rollback di uno schema:
pubsub.schemas.rollback
-
Convalida un messaggio:
pubsub.schemas.validate
-
Recupera il criterio IAM per uno schema:
pubsub.schemas.getIamPolicy
-
Configura il criterio IAM per uno schema:
pubsub.schemas.setIamPolicy
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Puoi concedere ruoli e autorizzazioni a entità come utenti, gruppi, domini o account di servizio. Puoi creare uno schema in un progetto e agganciarlo a un argomento in un altro progetto. Assicurati di disporre delle autorizzazioni necessarie per ogni progetto.
Crea uno schema
Puoi creare uno schema utilizzando la console Google Cloud, l'interfaccia a riga di comando gcloud CLI, l'API Pub/Sub o le librerie client di Cloud.
Prima di creare uno schema, consulta queste informazioni importanti sugli schemi.
Console
Per creare uno schema:
Nella console Google Cloud, vai alla pagina Schemi Pub/Sub.
Fai clic su Crea schema.
Nel campo Schema ID, inserisci un ID per lo schema.
Per le linee guida per la denominazione di uno schema, consulta Linee guida per la denominazione di un argomento, una sottoscrizione o uno snapshot.
In Tipo di schema, seleziona Avro o Protocol Buffer.
Scopri di più sui tipi di schemi.
Nel campo Definizione schema, inserisci la definizione di Avro o Protocol Buffer per lo schema.
Ad esempio, di seguito è riportato uno schema di esempio in Avro.
{ "type": "record", "name": "Avro", "fields": [ { "name": "ProductName", "type": "string", "default": "" }, { "name": "SKU", "type": "int", "default": 0 }, { "name": "InStock", "type": "boolean", "default": false } ] }
(Facoltativo) Fai clic su Convalida definizione per verificare se la definizione dello schema è corretta.
Il controllo di convalida non verifica la compatibilità dello schema con i messaggi da pubblicare. Testa i messaggi nel passaggio successivo.
(Facoltativo) Puoi verificare se i messaggi con lo schema corretto vengono pubblicati.
Fai clic su Test messaggio.
Nella finestra Test messaggio, seleziona un tipo di codifica del messaggio.
In Test message (Messaggio di test), inserisci un messaggio di test.
Fai clic su Test.
Ad esempio, di seguito è riportato un messaggio di esempio per lo schema di test. In questo esempio, seleziona Codifica dei messaggi come
JSON
.{"ProductName":"GreenOnions", "SKU":34543, "InStock":true}
Esci dalla pagina del messaggio di prova.
Fai clic su Crea per salvare lo schema.
gcloud
gcloud pubsub schemas create SCHEMA_ID \ --type=SCHEMA_TYPE \ --definition=SCHEMA_DEFINITION
Dove:
- SCHEMA_TYPE è
avro
oprotocol-buffer
. - SCHEMA_DEFINITION è un
string
contenente la definizione dello schema, formattata in base al tipo di schema scelto.
Puoi anche specificare la definizione dello schema in un file:
gcloud pubsub schemas create SCHEMA_ID \ --type=SCHEMA_TYPE \ --definition-file=SCHEMA_DEFINITION_FILE
Dove:
- SCHEMA_TYPE è
avro
oprotocol-buffer
. - SCHEMA_DEFINITION_FILE è un
string
contenente il percorso del file con la definizione dello schema, formattato in base al tipo di schema scelto.
REST
Per creare uno schema, invia una richiesta POST come la seguente:
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID Authorization: Bearer $(gcloud auth application-default print-access-token) Content-Type: application/json --data @response-body.json
Specifica i seguenti campi nel corpo della richiesta:
{ "definition": SCHEMA_DEFINITION "type": SCHEMA_TYPE }
Dove:
- SCHEMA_TYPE è
avro
oprotocol-buffer
. - SCHEMA_DEFINITION è una stringa contenente la definizione dello schema, formattata in base al tipo di schema scelto.
Il corpo della risposta deve contenere una rappresentazione JSON di una risorsa schema. Ad esempio:
{ "name": SCHEMA_NAME, "type": SCHEMA_TYPE, "definition": SCHEMA_DEFINITION "revisionId": REVISION_ID "revisionCreateTime": REVISION_CREATE_TIME }
Dove:
- REVISION_ID è l'ID generato dal server per la revisione.
- REVISION_CREATE_TIME è il timestamp ISO 8601 in cui è stata creata la revisione.
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
Proto
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
Proto
Vai
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
Proto
Java
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
Proto
Node.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
Proto
Node.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
Proto
PHP
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
Proto
Python
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
Proto
Ruby
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
Proto
Una volta creato uno schema, puoi visualizzarne i dettagli nella pagina Schemi.
Puoi associare lo schema a un argomento.