Présentation du schéma

Un schéma Pub/Sub est une fonctionnalité facultative que vous pouvez utiliser pour appliquer le format du champ données dans un message Pub/Sub.

Un schéma crée un contrat entre l'éditeur et l'abonné concernant le format des messages. Pub/Sub applique ce format. Les schémas facilitent la consommation des flux de données au sein de votre organisation en créant une autorité centrale pour les types de messages et les autorisations. Un schéma de message Pub/Sub définit les noms pour les champs d'un message.

Vous pouvez créer un schéma et l'associer à un sujet et d'appliquer le schéma des messages publiés. Si un message spécifique non conforme au schéma, le message n'est pas publié. Vous pouvez également créer des révisions supplémentaires pour un schéma.

Types de schémas

Vous pouvez créer un schéma dans Pub/Sub à l'aide de l'une des les cadres suivants:

Par exemple, le schéma suivant définit l'inventaire d'un entrepôt, d'abord au format Avro, puis au format Protocol Buffer.

Format Apache Avro

{
 "type" : "record",
 "name" : "Avro",
 "fields" : [
   {
     "name" : "ProductName",
     "type" : "string",
     "default": ""
   },
   {
     "name" : "SKU",
     "type" : "int",
     "default": 0
   },
   {
     "name" : "InStock",
     "type" : "boolean",
     "default": false
   }
 ]
}

Format du tampon de protocole

syntax = "proto3";
message ProtocolBuffer {
  string product_name = 1;
  int32 SKU = 2;
  bool in_stock = 3;
}

Informations importantes sur les schémas

Vous trouverez ci-dessous des informations importantes sur la création et la gestion de schémas Pub/Sub.

  • Pour qu'un schéma fonctionne avec Pub/Sub, vous ne devez définir Un type de niveau supérieur Les instructions d'importation qui font référence à d'autres types ne sont pas acceptées.

  • Vous pouvez associer le même schéma à plusieurs sujets.

  • Vous pouvez tester manuellement si un message est valide par rapport à un schéma.

Quotas et limites pour les schémas

Les limites suivantes s'appliquent aux schémas:

  • La taille du champ de définition de schéma ne peut pas dépasser 300 Ko.

  • Un projet peut comporter jusqu'à 10 000 schémas.

  • Un schéma ne peut pas comporter plus de 20 révisions.

    Pour en savoir plus sur les schémas et les limites liés à Pub/Sub, consultez la page Quotas et limites de Pub/Sub.

Étape suivante