Ringkasan skema

Skema Pub/Sub adalah fitur opsional yang dapat Anda gunakan untuk menerapkan format kolom data dalam pesan Pub/Sub.

Skema membuat kontrak antara penayang dan pelanggan tentang format pesan. Pub/Sub menerapkan format ini. Skema memfasilitasi penggunaan aliran data antar-tim di organisasi Anda dengan membuat otoritas pusat untuk jenis dan izin pesan. Skema pesan Pub/Sub menentukan nama dan jenis data untuk kolom dalam pesan.

Anda dapat membuat skema dan mengaitkannya dengan topik untuk menerapkan skema bagi pesan yang dipublikasikan. Jika pesan tertentu tidak sesuai dengan skema, pesan tersebut tidak akan dipublikasikan. Anda juga dapat membuat revisi tambahan untuk skema.

Jenis skema

Anda dapat membuat skema di Pub/Sub menggunakan salah satu framework berikut:

Misalnya, skema berikut menentukan inventaris gudang, pertama dalam format Avro, lalu dalam 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 Protocol Buffer

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

Informasi penting tentang skema

Berikut adalah beberapa informasi penting terkait pembuatan dan pengelolaan skema Pub/Sub.

  • Agar skema dapat berfungsi dengan Pub/Sub, Anda hanya boleh menentukan satu jenis tingkat atas type. Pernyataan impor yang mereferensikan jenis lain tidak didukung.

  • Anda dapat mengaitkan skema yang sama ke beberapa topik.

  • Anda dapat menguji secara manual apakah pesan divalidasi terhadap skema.

  • Jangan menyertakan informasi sensitif seperti informasi identitas pribadi (PII) atau data keamanan di nama kolom skema Anda.

Kuota dan batas untuk skema

Skema memiliki batas berikut:

  • Kolom definisi skema tidak boleh melebihi ukuran 300 KB.

  • Project dapat memiliki maksimum 10.000 skema.

  • Satu skema tidak boleh memiliki lebih dari 20 revisi.

    Untuk mengetahui informasi tentang skema dan batas terkait Pub/Sub, lihat Kuota dan batas Pub/Sub.

Langkah berikutnya