Dokumen ini menunjukkan cara memvalidasi skema untuk topik Pub/Sub.
Anda dapat memvalidasi bahwa pesan mematuhi skema tertentu, sebelum atau setelah membuat resource skema. Langkah ini memastikan bahwa pesan yang ingin Anda kirim melalui topik yang terkait dengan skema benar-benar cocok sebelum menerapkan skema.
Sebelum memulai
- Memahami cara kerja skema Pub/Sub.
- Buat skema.
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk memvalidasi pesan skema dan mengelolanya,
minta administrator untuk memberi Anda peran IAM
Pub/Sub Editor (roles/pubsub.editor
) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.
Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk memvalidasi pesan skema dan mengelolanya. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk memvalidasi pesan skema dan mengelolanya:
-
Buat skema:
pubsub.schemas.create
-
Lampirkan skema ke topik:
pubsub.schemas.attach
-
Commit revisi skema:
pubsub.schemas.commit
-
Hapus skema atau revisi skema:
pubsub.schemas.delete
-
Mendapatkan skema atau revisi skema:
pubsub.schemas.get
-
Skema daftar:
pubsub.schemas.list
-
Mencantumkan revisi skema:
pubsub.schemas.listRevisions
-
Melakukan rollback skema:
pubsub.schemas.rollback
-
Validasi pesan:
pubsub.schemas.validate
-
Mendapatkan kebijakan IAM untuk skema:
pubsub.schemas.getIamPolicy
-
Konfigurasi kebijakan IAM untuk skema:
pubsub.schemas.setIamPolicy
Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.
Anda dapat memberikan peran dan izin ke akun utama seperti pengguna, grup, domain, atau akun layanan. Anda dapat membuat skema dalam satu project dan melampirkannya ke topik yang berada di project berbeda. Pastikan Anda memiliki izin yang diperlukan untuk setiap project.
Memvalidasi pesan untuk skema
Konsol
Di konsol Google Cloud, buka halaman Pub/Sub scheme.
Daftar skema ditampilkan.
Klik Schema ID dari skema yang sudah ada.
Halaman Detail skema untuk skema akan terbuka.
Di bagian Revisi, klik revisi yang pesannya ingin Anda validasi.
Di bagian Details, klik Test message.
Di jendela Test message, pilih jenis Encoding pesan.
Dalam isi Message, masukkan pesan pengujian.
Klik Uji.
gcloud
-
Di konsol Google Cloud, aktifkan Cloud Shell.
Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.
- Untuk memvalidasi pesan berdasarkan skema, gunakan perintah gcloud pubsub pelajar 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))
Ganti kode berikut:
MESSAGE: pesan untuk memvalidasi terhadap skema
MESSAGE_ENCODING: encoding pesan. Tentukan salah satu dari nilai berikut:
binary
ataujson
.SCHEMA_NAME: nama atau jalur lengkap dari skema yang ada.
TYPE: jenis skema inline. Tentukan salah satu nilai berikut:
avro
atauprotocol-buffer
.DEFINITION: definisi skema inline.
DEFINITION_FILE: file yang berisi definisi skema.