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 keduanya, Anda akan menerima error penolakan izin.
Untuk mengatasi masalah ini:
Pastikan instance dan tabel ada. Untuk informasi selengkapnya, baca dokumen berikut:
Jika tidak ada, buat dan coba lagi membuat langganan Anda. 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_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 column family.
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 mungkin 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 yang tidak ada.
Langganan tidak dapat menulis ke tabel Bigtable karena kebijakan penyimpanan pesan. Error ini terjadi jika
enforceInTransitadalahTruedan lokasi tabel tidak berada di wilayah yang diizinkan.
Saat langganan dalam status error, langganan tidak menulis pesan ke tabel Bigtable. Pesan tetap berada di backlog langganan; pesan tidak dikirim ke topik pesan yang tidak terkirim, jika dikonfigurasi. Pesan yang tidak terkonfirmasi akan dipertahankan selama durasi retensi pesan langganan.
Setelah masalah teratasi, langganan akan kembali ke status normal.
Meningkatkan backlog
Jika status langganan Anda adalah ACTIVE, tetapi ada backlog pesan yang terus meningkat dalam langganan, atau pesan masuk ke topik surat mati langganan, cari masalah berikut.
Rasio publikasi melebihi kapasitas
Jika kecepatan memublikasikan pesan ke topik Anda melebihi kapasitas cluster Bigtable, backlog mungkin menumpuk di 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 berurutan.
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 membutuhkan 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 Anda.
Langkah berikutnya
- Jika Anda masih mengalami masalah dengan langganan Bigtable, lihat Mendapatkan dukungan.