Questo documento mostra come convalidare gli schemi per gli argomenti Pub/Sub.
Puoi verificare che i messaggi rispettino un determinato schema, prima o dopo aver creato una risorsa di schema. Questo passaggio garantisce la corrispondenza effettiva dei messaggi che intendi inviare tramite un argomento associato a uno schema prima di applicare lo schema.
Prima di iniziare
- Scopri come funzionano gli schemi Pub/Sub.
- Crea uno schema.
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni necessarie per convalidare i messaggi di schema e gestirli,
chiedi all'amministratore di concederti il ruolo IAM
Editor Pub/Sub (roles/pubsub.editor
) per il tuo progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questo ruolo predefinito contiene le autorizzazioni necessarie per convalidare i messaggi dello schema e gestirli. Per visualizzare esattamente le autorizzazioni necessarie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per convalidare i messaggi dello schema e gestirli sono necessarie le seguenti autorizzazioni:
-
Crea schema:
pubsub.schemas.create
-
Collega 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 una revisione dello schema:
pubsub.schemas.get
-
Elenca gli schemi:
pubsub.schemas.list
-
Elenca le revisioni dello schema:
pubsub.schemas.listRevisions
-
Esegui il rollback di uno schema:
pubsub.schemas.rollback
-
Convalida un messaggio:
pubsub.schemas.validate
-
Ottieni il criterio IAM per uno schema:
pubsub.schemas.getIamPolicy
-
Configura il criterio IAM per uno schema:
pubsub.schemas.setIamPolicy
Potresti anche riuscire a ottenere queste autorizzazioni con i 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 collegarlo a un argomento situato in un altro progetto. Assicurati di disporre delle autorizzazioni necessarie per ogni progetto.
Convalida un messaggio per uno schema
Console
Nella console Google Cloud, vai alla pagina Schemi Pub/Sub.
Viene visualizzato l'elenco degli schemi.
Fai clic sull'ID schema di uno schema esistente.
Si apre la pagina Dettagli schema relativa allo schema.
Nella sezione Revisioni, fai clic sulla revisione per cui vuoi convalidare un messaggio.
Nella sezione Dettagli, fai clic su Verifica messaggio.
Nella finestra Messaggio di prova, seleziona un tipo di Codifica del messaggio.
Nel corpo del Messaggio, inserisci un messaggio di prova.
Fai clic su Test.
gcloud
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
- Per convalidare un messaggio in base a uno schema, utilizza il comando gcloud pubsub schemis validation-message.
gcloud pubsub schemas validate-message --message=MESSAGE \ --message-encoding=MESSAGE_ENCODING \ (--schema-name=SCHEMA_NAME | \ --type=TYPE \ (--definition=DEFINITION | \ --definition-file=DEFINITION_FILE))
Sostituisci quanto segue:
MESSAGE: messaggio da convalidare in base allo schema
MESSAGE_ENCODING: codifica del messaggio. Specifica uno dei seguenti valori:
binary
ojson
.SCHEMA_NAME: nome o percorso completo di uno schema esistente.
TYPE: tipo di schema in linea. Specifica uno dei seguenti valori:
avro
oprotocol-buffer
.DEFINITION: definizione dello schema incorporato.
DEFINITION_FILE: file contenente la definizione dello schema.