Memecahkan masalah langganan BigQuery

Halaman ini memberikan beberapa tips pemecahan masalah umum untuk langganan BigQuery.

Memeriksa status langganan BigQuery

Untuk memeriksa status langganan, lakukan langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman langganan Pub/Sub.

    Buka Langganan

  2. Periksa ikon Status untuk langganan BigQuery Anda.

    Jika ikonnya tanda centang hijau, berarti langganan tersebut sehat.

    Jika ikonnya adalah tanda seru berwarna merah, langganan akan mengalami status error.

  3. Klik langganan BigQuery.

    Halaman detail langganan akan terbuka.

  4. Periksa Status langganan untuk melihat pesan error.

  5. Bergantung pada pesan error-nya, buka bagian yang relevan di halaman ini untuk memecahkan masalah Anda.

Setelah masalah teratasi, langganan akhirnya kembali ke status responsif.

Error membuat atau memperbarui tabel pengembalian langganan

Jika tabel yang Anda tentukan dalam alur kerja pembuatan atau pembaruan langganan tidak ada, alur kerja akan menampilkan error tabel tidak ditemukan. Di konsol Google Cloud, pesannya mirip dengan pesan berikut:

The BigQuery table or dataset specified cannot be found.

Untuk mengatasi masalah ini, buat tabel dan pastikan Anda dapat memeriksa state sebelum menggunakannya dengan langganan BigQuery.

Membuat atau memperbarui langganan akan menampilkan error ketidakcocokan skema

Jika skema tabel dan topik tidak kompatibel, alur kerja langganan pembuatan atau update akan menampilkan error ketidakcocokan skema. Di konsol Google Cloud, pesannya mirip dengan pesan berikut:

Incompatible schema type for field project_ids: expected INT64, got STRING

Pesan error yang ditentukan ditujukan untuk ketidakcocokan skema bagi kolom yang disebut project_ids. Bergantung pada jenis ketidakcocokan skema yang Anda miliki, Anda mungkin akan melihat variasi pesan error yang berbeda.

Untuk mengatasi masalah ini, periksa apakah pemetaan skema kompatibel.

Membuat atau memperbarui langganan akan menampilkan error akun layanan

Jika Anda belum mengonfigurasi akun layanan Pub/Sub dengan izin yang tepat, alur kerja pembuatan atau pembaruan langganan akan menampilkan error. Di konsol Google Cloud, pesannya mirip dengan pesan berikut:

Service account service-1234234234@gcp-sa-pubsub.iam.gserviceaccount.com
is missing permissions required to write to the BigQuery table:
bigquery.tables.get, bigquery.tables.updateData.

Untuk mengatasi masalah ini, periksa apakah akun layanan memiliki izin yang benar.

Status langganan menampilkan tanda seru berwarna merah

Jika Anda mengedit tabel setelah membuat langganan, tindakan tersebut dapat memengaruhi cara Pub/Sub menulis pesan ke tabel tersebut. Jika perubahan mengakibatkan masalah, kolom status langganan akan disetel ke status error.

Di halaman detail langganan, periksa status kolom Subscription state. Kolom Subscription state memberikan error yang lebih spesifik, yang mungkin berupa salah satu dari hal berikut:

  • tabel tidak ditemukan: Tabel dihapus. Buat tabel dan periksa statusnya. Lihat Mendapatkan informasi tabel.

  • izin tabel ditolak: Akun layanan Pub/Sub tidak lagi memiliki izin untuk menulis ke tabel. Periksa apakah akun layanan memiliki izin yang benar.

  • skema tabel tidak cocok: Skema tabel tidak lagi kompatibel dengan setelan langganan BigQuery. Periksa apakah pemetaan skema kompatibel.

Ketika langganan Pub/Sub berada dalam status error, pesan tidak ditulis ke tabel BigQuery dan tetap berada di backlog langganan. Perlu diperhatikan bahwa pesan tidak dikirim ke topik yang dihentikan pengirimannya, jika dikonfigurasi. Pesan yang tidak dikonfirmasi akan dipertahankan selama periode yang ditetapkan pada message_retention_duration(7 hari, secara default).

Langkah selanjutnya