Dokumen ini memberikan tips pemecahan masalah untuk langganan Bigtable.
Tidak dapat membuat atau memperbarui langganan
Saat mencoba membuat atau memperbarui langganan Bigtable, Anda mungkin mengalami error berikut.
Error izin ditolak
Jika instance atau tabel Bigtable tidak ada, atau akun layanan yang dikonfigurasi tidak memiliki akses ke salah satunya, Anda akan menerima error izin ditolak.
Untuk mengatasi masalah ini:
Periksa apakah instance dan tabel ada. Untuk mengetahui informasi selengkapnya, lihat dokumen berikut:
Jika tidak ada, buat instance dan tabel, lalu coba lagi membuat langganan. Untuk contoh langkah ini, lihat Menulis dari Pub/Sub ke Bigtable.
Jika Anda masih mendapatkan error ini, periksa apakah akun layanan memiliki izin yang benar. Untuk mengetahui informasi selengkapnya, lihat Memberikan peran IAM ke akun layanan.
Grup kolom tidak ada
Jika tabel Bigtable tidak memiliki grup kolom yang benar, Anda akan menerima error INCOMPATIBLE_BIGTABLE_SCHEMA.
Error ini dapat disebabkan oleh masalah berikut:
- Tabel tidak memiliki grup kolom
data. - Penulisan metadata
diaktifkan, dan tabel tidak memiliki grup kolom
pubsub_metadata.
Untuk mengatasi masalah ini, buat grup kolom yang diperlukan. Untuk mengetahui informasi selengkapnya, lihat Menambahkan grup kolom.
Langganan tidak menulis data
Jika langganan Bigtable tidak menulis data, periksa status langganan dengan menjalankan perintah
gcloud beta pubsub subscriptions describe:
gcloud beta pubsub subscriptions describe SUBSCRIPTION_ID
Ganti SUBSCRIPTION_ID dengan nama langganan.
Kolom bigtableConfig.state berisi status. Jika langganan siap menulis pesan ke Bigtable, statusnya adalah ACTIVE.
Jika tidak, ada error dalam konfigurasi yang mencegah langganan menulis pesan ke tabel Bigtable.
Masalah konfigurasi dapat mencakup hal berikut:
Profil aplikasi tidak dikonfigurasi untuk perutean cluster tunggal.
Error izin. Lihat Error izin ditolak.
Tabel Bigtable tidak memiliki grup kolom yang diperlukan. Lihat Grup kolom tidak ada.
Langganan tidak dapat menulis ke tabel Bigtable karena kebijakan penyimpanan pesan. Error ini terjadi jika
enforceInTransitadalahTruedan lokasi tabel tidak berada di region yang diizinkan.
Saat langganan dalam status error, langganan tidak akan menulis pesan ke tabel Bigtable. Pesan tetap berada di backlog langganan; pesan tidak dikirim ke topik yang dihentikan pengirimannya, jika dikonfigurasi. Pesan yang tidak terkonfirmasi disimpan selama durasi retensi pesan langganan .
Setelah masalah teratasi, langganan akan kembali ke status normal.
Backlog meningkat
Jika status langganan Anda adalah ACTIVE, tetapi ada backlog pesan yang meningkat dalam langganan, atau pesan masuk ke topik pesan yang tidak terkirim langganan, cari masalah berikut.
Frekuensi publikasi melebihi kapasitas
Jika frekuensi publikasi pesan ke topik Anda melebihi kapasitas cluster Bigtable, backlog mungkin akan menumpuk dalam langganan.
Pengurutan pesan memiliki kompromi performa. Menggunakan langganan Bigtable dengan pengurutan dapat menyebabkan throughput yang lebih rendah atau latensi pengiriman pesan yang lebih tinggi. Jika Anda melihat masalah performa dengan pengurutan yang diaktifkan, pastikan untuk menggunakan kunci pengurutan yang cukup terperinci untuk menghindari kunci aktif, atau ubah aplikasi Anda agar tidak memerlukan pengurutan. Untuk mengetahui informasi selengkapnya, lihat Pertimbangan saat menggunakan pesan yang diurutkan.
Pantau performa cluster Anda dan pertimbangkan untuk meningkatkan ukuran cluster. Untuk mengetahui informasi selengkapnya, lihat topik berikut dalam dokumentasi Bigtable:
Traffic lintas region
Jika aplikasi Anda memublikasikan ke topik dari region yang berbeda dengan cluster Bigtable, setiap pesan akan memerlukan waktu lebih lama untuk dipublikasikan, dibandingkan dengan memublikasikan dari region yang sama. Waktu publikasi yang lebih lama akan mengurangi frekuensi langganan Anda menulis pesan ke Bigtable, sehingga mengurangi total throughput.
Untuk meminimalkan waktu yang diperlukan agar pesan dipublikasikan, Anda harus memublikasikannya di region yang sama dengan cluster Bigtable.
Langkah berikutnya
- Jika Anda masih mengalami masalah dengan langganan Bigtable, lihat Mendapatkan dukungan.