Valider une révision de schéma

Ce document vous explique comment valider une révision de schéma pour les sujets Pub/Sub.

Avant de commencer

• Comprendre le fonctionnement des schémas Pub/Sub
• Créer un schéma.

Rôles et autorisations requis

Pour obtenir les autorisations nécessaires pour valider une révision de schéma et gérer des schémas, demandez à votre administrateur de vous accorder le rôle Éditeur Pub/Sub (roles/pubsub.editor) dans votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour valider une révision de schéma et gérer des schémas. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour valider une révision de schéma et gérer des schémas :

• Créer un schéma : pubsub.schemas.create
• Associer un schéma à un sujet : pubsub.schemas.attach
• Valider une révision de schéma : pubsub.schemas.commit
• Supprimer un schéma ou une révision de schéma : pubsub.schemas.delete
• Obtenir un schéma ou des révisions de schéma : pubsub.schemas.get
• Lister les schémas : pubsub.schemas.list
• Lister les révisions de schéma : pubsub.schemas.listRevisions
• Effectuer un rollback d'un schéma : pubsub.schemas.rollback
• Valider un message : pubsub.schemas.validate
• Obtenir la stratégie IAM pour un schéma : pubsub.schemas.getIamPolicy
• Configurer la stratégie IAM pour un schéma : pubsub.schemas.setIamPolicy

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Vous pouvez accorder des rôles et des autorisations à des principaux tels que des utilisateurs, des groupes, des domaines ou des comptes de service. Vous pouvez créer un schéma dans un projet et l'associer à un sujet situé dans un autre projet. Assurez-vous de disposer des autorisations requises pour chaque projet.

Réviser un schéma

Vous pouvez valider une révision de schéma à l'aide de la Google Cloud console, de gcloud CLI, de l'API Pub/Sub, ou des bibliothèques clientes Cloud.

Voici quelques consignes à suivre pour valider une révision de schéma :

• Vous pouvez réviser un schéma dans certaines limites :

  • Pour les schémas de tampon de protocole, vous pouvez ajouter ou supprimer des champs facultatifs. Vous ne pouvez pas ajouter ni supprimer d'autres champs. Vous ne pouvez pas non plus modifier de champ existant.

  • Pour les schémas Avro, consultez la documentation Avro pour connaître les règles de résolution des schémas. Une nouvelle révision doit suivre les règles comme s'il s'agissait à la fois du schéma du lecteur et du schéma de l'auteur.

  • Un schéma peut comporter jusqu'à 20 révisions à la fois. Si vous dépassez cette limite, supprimez une révision de schéma avant d'en créer une autre.

• Chaque révision est associée à un ID de révision unique. L'ID de révision est un UUID à huit caractères généré automatiquement.

• Lorsque vous mettez à jour la plage de révisions ou la révision d'un schéma utilisé pour la validation de sujet, l'application des modifications peut prendre quelques minutes.