Mode pembaruan skema

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Mode skema menentukan apakah registry skema atau subjek tertentu mengizinkan perubahan, seperti menulis atau mengedit skema.

• Nilai yang didukung untuk mode skema adalah Readonly dan Readwrite.

• Mode skema dikelola sebagai objek JSON yang berisi key-value pair. Misalnya, berikut adalah contohnya:

  {
    "mode": "READWRITE"
  }
  

• Jika tidak ditetapkan secara eksplisit di tingkat registry skema, mode skema akan ditetapkan secara default ke Readwrite.

• Jika mode skema tidak ditentukan secara eksplisit di tingkat subjek, mode skema akan mewarisi nilai dari registry skema.

• Konfigurasi yang ditetapkan di tingkat subjek akan mengganti konfigurasi yang ditetapkan di tingkat registry skema.

Untuk mengetahui informasi selengkapnya tentang mode skema, termasuk nilainya, lihat Mode skema.

Peran dan izin yang diperlukan untuk memperbarui mode skema

Untuk mendapatkan izin yang diperlukan guna memperbarui mode skema untuk registry atau subjek skema, minta administrator untuk memberi Anda peran IAM Managed Kafka Schema Registry Editor (roles/managedkafka.schemaRegistryEditor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk memperbarui mode skema untuk registry atau subjek skema. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memperbarui mode skema untuk registry atau subjek skema:

• Berikan izin berikut pada resource yang modenya ingin Anda perbarui: managedkafka.mode.update

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Memperbarui mode skema untuk registry skema

Konsol

Untuk memperbarui mode skema untuk seluruh registry skema, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Schema registries.

   Buka Registry skema

   Daftar registry skema di project Anda akan ditampilkan.

2. Klik nama registry skema yang mode skemanya ingin Anda perbarui.

   Halaman Schema registry details akan terbuka.

3. Di bagian detail utama untuk registry, temukan setelan Schema mode , lalu klik ikon Edit di sampingnya.

   Halaman Edit schema mode akan terbuka.

4. Dari menu dropdown Schema mode, pilih nilainya.

   Untuk mengetahui informasi selengkapnya tentang nilai ini, lihat Tentang mode skema.

5. Klik Save.

gcloud

Untuk memperbarui mode skema untuk registry skema, gunakan gcloud alpha managed-kafka schema-registries update perintah:

gcloud alpha managed-kafka schema-registries update SCHEMA_REGISTRY_ID \
    --location=LOCATION \
    --mode=MODE_TYPE

• SCHEMA_REGISTRY_ID: ID registry skema yang akan diperbarui.
• LOCATION: region registry skema yang akan diperbarui.
• MODE_TYPE: mode skema baru. Nilai yang valid adalah:
  • READWRITE
  • READONLY

Contoh:

Untuk memperbarui mode skema registry skema test-registry di region us-central1 menjadi READONLY, jalankan perintah berikut:

gcloud alpha managed-kafka schema-registries update test-registry \
    --location=us-central1 \
    --mode=READONLY

REST

Permintaan harus diautentikasi dengan token akses di header Authorization. Untuk mendapatkan token akses untuk Kredensial Default Aplikasi saat ini: gcloud auth application-default print-access-token.

Untuk memperbarui mode skema, buat permintaan PUT ke endpoint REST API untuk registry skema menggunakan metode projects.locations.schemaRegistries.contexts.mode.update.

Memperbarui mode skema untuk registry skema dengan konteks default:

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/mode

Ganti parameter jalur berikut:

• PROJECT_ID: Project ID Google Cloud Anda.
• LOCATION: region tempat registry skema berada.
• SCHEMA_REGISTRY_ID: ID unik registry skema.

Isi permintaan:

Sertakan objek JSON di isi permintaan yang menentukan detail mode.

{
  "mode": "MODE_TYPE"
}

Ganti MODE_TYPE dengan salah satu opsi string yang valid untuk mode:

• READWRITE
• READONLY

Jika berhasil, API akan menampilkan kode status 200 OK dan isi respons yang berisi representasi JSON dari konfigurasi mode yang diperbarui.

Untuk mendapatkan informasi lebih lanjut, lihat dokumentasi REST API.

Memperbarui mode skema untuk subjek

Konsol

Untuk memperbarui mode skema untuk subjek tertentu, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Schema registries.

   Buka Registry skema

2. Klik nama registry skema yang berisi subjek.

   Halaman Schema registry details akan terbuka.

3. Di tabel Subjects in this schema registry, klik nama subjek yang mode skemanya ingin Anda perbarui.
4. Temukan setelan Schema mode untuk subjek, lalu klik ikon Edit di sampingnya.

   Halaman Edit schema mode akan terbuka.

5. Dari menu dropdown Schema mode, pilih nilainya. Memilih nilai di sini akan mengganti setelan tingkat registry untuk subjek tertentu ini.

   Untuk mengetahui informasi selengkapnya tentang nilai ini, lihat Tentang mode skema.

6. Klik Save.

gcloud

Untuk memperbarui mode skema untuk subjek, gunakan gcloud alpha managed-kafka schema-registries subject update perintah:

gcloud alpha managed-kafka schema-registries subject update SUBJECT_NAME \
    --schema-registry=SCHEMA_REGISTRY_ID \
    --location=LOCATION \
    --mode=MODE_TYPE

• SUBJECT_NAME: nama subjek yang akan diperbarui.
• SCHEMA_REGISTRY_ID: ID registry skema yang berisi subjek.
• LOCATION: region registry skema yang berisi subjek.
• MODE_TYPE: mode skema baru. Nilai yang valid adalah:
  • READWRITE
  • READONLY

Contoh:

Untuk memperbarui mode skema subjek test-subject di registry skema test-registry di region us-central1 menjadi READONLY, jalankan perintah berikut:

gcloud alpha managed-kafka schema-registries subject update test-subject \
    --schema-registry=test-registry \
    --location=us-central1 \
    --mode=READONLY

REST

Permintaan harus diautentikasi dengan token akses di header Authorization. Untuk mendapatkan token akses untuk Kredensial Default Aplikasi saat ini: gcloud auth application-default print-access-token.

Untuk memperbarui mode skema untuk subjek, buat permintaan PUT ke endpoint REST API untuk subjek tertentu menggunakan projects.locations.schemaRegistries.contexts.mode.update metode.

Memperbarui mode skema untuk subjek dalam konteks default:

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/mode/SUBJECT_NAME

Ganti parameter jalur berikut:

• PROJECT_ID: Project ID Google Cloud Anda.
• LOCATION: region tempat registry skema berada.
• SCHEMA_REGISTRY_ID: ID unik registry skema.
• SUBJECT_NAME: nama subjek.

Isi permintaan:

Sertakan objek JSON di isi permintaan yang menentukan detail mode.

{
  "mode": "MODE_TYPE"
}

Ganti MODE_TYPE dengan salah satu opsi string yang valid untuk mode:

• READWRITE
• READONLY

Contoh—Menetapkan mode skema subjek user_events ke Readonly dalam konteks default:

Permintaan ke PUT https://managedkafka.googleapis.com/v1main/projects/test-gcp-project/locations/us-east1/schemaRegistries/main_registry/mode/user_events

Dengan isi:

{
  "mode": "READONLY"
}

Jika berhasil, API akan menampilkan kode status 200 OK dan isi respons yang berisi representasi JSON dari resource subjek atau konteks yang diperbarui yang mencerminkan perubahan ini.

Memperbarui mode skema untuk subjek dalam konteks tertentu:

PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/contexts/CONTEXT_NAME/mode/SUBJECT_NAME

Ganti parameter jalur berikut:

• PROJECT_ID: Project ID Google Cloud Anda.
• LOCATION: region tempat registry skema berada.
• SCHEMA_REGISTRY_ID: ID unik registry skema.
• CONTEXT_NAME: nama konteks.
• SUBJECT_NAME: nama subjek.

Isi permintaan:

Sertakan objek JSON di isi permintaan yang menentukan detail mode.

{
  "mode": "MODE_TYPE"
}

Ganti MODE_TYPE dengan salah satu opsi string yang valid untuk mode:

• READWRITE
• READONLY

Contoh—Menetapkan mode skema subjek user_events ke Readonly dalam konteks test_context:

Permintaan ke PUT https://managedkafka.googleapis.com/v1main/projects/test-gcp-project/locations/us-east1/schemaRegistries/main_registry/contexts/test_context/mode/user_events

Dengan isi:

{
  "mode": "READONLY"
}

Jika berhasil, API akan menampilkan kode status 200 OK dan isi respons yang berisi representasi JSON dari resource subjek atau konteks yang diperbarui yang mencerminkan perubahan ini.

Untuk mendapatkan informasi lebih lanjut, lihat dokumentasi REST API.

Langkah berikutnya

• Memperbarui jenis kompatibilitas

• Membuat subjek dan mendaftarkan skema

• Melihat detail registry skema

• Mencantumkan subjek dalam registry skema

Apache Kafka® adalah merek dagang terdaftar dari The Apache Software Foundation atau afiliasinya di Amerika Serikat dan/atau negara lain.