架构概览

Pub/Sub 架构是一项可选功能,可用于强制要求 Pub/Sub 消息中的数据字段遵循一定的格式。

架构在发布者和订阅者之间就 消息格式Pub/Sub 强制执行此格式。 架构有助于团队间使用 Google Cloud 中的数据流 从而为消息类型和 权限。Pub/Sub 消息架构定义消息中字段的名称和数据类型。

您可以创建一个架构并将其与某个主题相关联,以强制要求发布的消息遵循此架构。如果特定消息不符合架构,系统将不会发布该消息。您还可以为架构创建其他修订版本。

架构类型

您可以使用以下任一框架在 Pub/Sub 中创建架构:

创建架构后,您可以对 架构或架构修订版本例如,您可以删除架构删除架构修订版本

例如,以下架构定义了仓库的商品目录,先是 Avro 格式,然后是 Protocol Buffer 格式。

Apache Avro 格式

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

Protocol Buffer 格式

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

架构的配额和限制

架构具有以下限制:

  • 架构定义字段的大小不得超过 300 KB。

  • 一个项目最多可以有 10,000 个架构。

  • 单个架构的修订版本不能超过 20 个。

    如需了解与 Pub/Sub 相关的架构和限制,请参阅 Pub/Sub 配额和限制

后续步骤