Tutorial ini menunjukkan cara menggunakan template Bigtable change stream ke Pub/Sub, termasuk cara menyiapkan topik dan mengonfigurasi template. Secara opsional, Anda dapat membuat fungsi Cloud Run, dalam bahasa pemrograman pilihan Anda, yang dipicu oleh aliran peristiwa.
Tutorial ini ditujukan untuk pengguna teknis yang sudah memahami Bigtable, menulis kode, dan layanan streaming peristiwa.
Tujuan
Tutorial ini menunjukkan cara melakukan hal berikut:
- Buat tabel Bigtable dengan aliran data perubahan diaktifkan.
- Buat topik Pub/Sub dengan skema aliran perubahan Bigtable.
- Deploy aliran perubahan Bigtable ke pipeline Pub/Sub di Dataflow menggunakan template.
- Lihat aliran peristiwa di Pub/Sub secara langsung atau di log fungsi Cloud Run.
Biaya
Dalam dokumen ini, Anda akan menggunakan komponen Google Cloudyang dapat ditagih berikut:
Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda,
gunakan kalkulator harga.
Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.
Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Dataflow, Cloud Bigtable API, Cloud Bigtable Admin API, Pub/Sub, Cloud Run functions, and Cloud Storage APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Dataflow, Cloud Bigtable API, Cloud Bigtable Admin API, Pub/Sub, Cloud Run functions, and Cloud Storage APIs.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
- Update dan instal
cbt
CLI.gcloud components update gcloud components install cbt
Membuat topik Pub/Sub
Di konsol Google Cloud, buka halaman Topics Pub/Sub.
Klik Create topic.
Tetapkan ID ke
bigtable-change-stream-topic
.Pilih Gunakan skema.
Di drop-down Select a Pub/Sub schema, klik Create new schema. Tindakan ini akan membuka tab baru tempat Anda menentukan skema.
- Tetapkan ID skema ke
bigtable-change-stream-schema
. - Tetapkan jenis skema ke Avro.
- Tempelkan kode berikut sebagai definisi skema. Informasi selengkapnya tentang skema dapat ditemukan di halaman dokumentasi template.
{ "name" : "ChangelogEntryMessage", "type" : "record", "namespace" : "com.google.cloud.teleport.bigtable", "fields" : [ { "name" : "rowKey", "type" : "bytes"}, { "name" : "modType", "type" : { "name": "ModType", "type": "enum", "symbols": ["SET_CELL", "DELETE_FAMILY", "DELETE_CELLS", "UNKNOWN"]} }, { "name": "isGC", "type": "boolean" }, { "name": "tieBreaker", "type": "int"}, { "name": "columnFamily", "type": "string"}, { "name": "commitTimestamp", "type" : "long"}, { "name" : "sourceInstance", "type" : "string"}, { "name" : "sourceCluster", "type" : "string"}, { "name" : "sourceTable", "type" : "string"}, { "name": "column", "type" : ["null", "bytes"]}, { "name": "timestamp", "type" : ["null", "long"]}, { "name": "timestampFrom", "type" : ["null", "long"]}, { "name": "timestampTo", "type" : ["null", "long"]}, { "name" : "value", "type" : ["null", "bytes"]} ] }
- Klik Create untuk membuat skema.
- Tetapkan ID skema ke
Tutup tab Create schema, muat ulang daftar skema, lalu pilih skema yang baru ditentukan.
Klik Create untuk membuat topik.
Opsional: Membuat fungsi Cloud Run
Anda mungkin ingin memproses streaming Pub/Sub dengan fungsi Cloud Run.
- Di halaman Details untuk topik
bigtable-change-stream-topic
, klik Trigger Cloud Function . - Di kolom Nama fungsi, masukkan nama
bt-ps-tutorial-function
. - Di bagian Kode Sumber, klik drop-down Runtime, lalu
pilih runtime dan bahasa pemrograman pilihan Anda.
hello world
dibuat yang mencetak aliran perubahan saat masuk. Lihat dokumentasi untuk mempelajari lebih lanjut cara menulis fungsi Cloud Run. - Gunakan nilai default untuk semua kolom lainnya.
- Klik Deploy function.
Membuat tabel dengan aliran perubahan diaktifkan
Di konsol Google Cloud, buka halaman Instance Bigtable.
Klik ID instance yang Anda gunakan untuk tutorial ini.
Jika Anda tidak memiliki instance, buat instance dengan konfigurasi default di wilayah yang dekat dengan Anda.
Di panel navigasi kiri, klik Tables.
Klik Buat tabel.
Beri nama tabel
change-streams-pubsub-tutorial
.Tambahkan keluarga kolom bernama
cf
.Pilih Aktifkan aliran data perubahan.
Klik Buat.
Melakukan inisialisasi pipeline data untuk mengambil aliran perubahan
- Di halaman Tabel Bigtable, temukan tabel
change-streams-pubsub-tutorial
Anda. - Di kolom Change stream, klik Connect.
- Pada dialog, pilih Pub/Sub.
- Klik Buat tugas Dataflow.
- Di halaman Create job Dataflow, tetapkan nama topik Pub/Sub output ke:
bigtable-change-stream-topic
. - Tetapkan ID profil aplikasi Bigtable ke
default
. - Klik Run job.
- Tunggu hingga status tugas menjadi Starting atau Running sebelum melanjutkan. Perlu waktu sekitar 5 menit setelah tugas diantrekan.
Menulis beberapa data ke Bigtable
Di Cloud Shell, tulis beberapa baris ke Bigtable sehingga log perubahan dapat menulis beberapa data ke aliran Pub/Sub. Selama Anda menulis data setelah tugas dibuat, perubahan akan muncul. Anda tidak perlu menunggu status tugas menjadi
running
.cbt -instance=BIGTABLE_INSTANCE_ID -project=YOUR_PROJECT_ID \ set change-streams-pubsub-tutorial user123 cf:col1=abc cbt -instance=BIGTABLE_INSTANCE_ID -project=YOUR_PROJECT_ID \ set change-streams-pubsub-tutorial user546 cf:col1=def cbt -instance=BIGTABLE_INSTANCE_ID -project=YOUR_PROJECT_ID \ set change-streams-pubsub-tutorial user789 cf:col1=ghi
Melihat log perubahan di Pub/Sub
Di konsol Google Cloud, buka halaman Subscriptions Pub/Sub.
Klik langganan yang dibuat otomatis untuk topik Anda
bigtable-change-stream-topic
. Class ini harus diberi namabigtable-change-stream-topic-sub
.Buka tab Pesan.
Klik Pull.
Jelajahi daftar pesan dan lihat data yang Anda tulis.
Opsional: Melihat perubahan dalam log fungsi Cloud Run
Jika membuat fungsi Cloud Run, Anda dapat melihat perubahan dalam log.
Di konsol Google Cloud, buka fungsi Cloud Run.
Klik fungsi Anda
bt-ps-tutorial-function
.Buka tab Logs.
Pastikan Severity ditetapkan setidaknya ke Info agar Anda dapat melihat log.
Jelajahi log dan lihat data yang Anda tulis.
Outputnya terlihat mirip dengan yang berikut ini:
Pub/Sub message: {"rowKey":"user789","modType":"SET_CELL","isGC":false,"tieBreaker":0,"columnFamily":"cf","commitTimestamp":1695653833064548,"sourceInstance":"YOUR-INSTANCE","sourceCluster":"YOUR-INSTANCE-c1","sourceTable":"change-streams-pubsub-tutorial","column":{"bytes":"col1"},"timestamp":{"long":1695653832278000},"timestampFrom":null,"timestampTo":null,"value":{"bytes":"ghi"}}
Pembersihan
Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.
Menghapus tabel Bigtable
Di konsol Google Cloud, buka halaman Instance Bigtable.
Klik ID instance yang Anda gunakan untuk tutorial ini.
Di panel navigasi kiri, klik Tables.
Temukan tabel
change-streams-pubsub-tutorial
.Klik Edit.
Hapus centang Aktifkan aliran perubahan.
Klik Save.
Buka menu tambahan untuk tabel.
Klik Hapus dan masukkan nama tabel untuk mengonfirmasi.
Menghentikan pipeline aliran data perubahan
Di konsol Google Cloud, buka halaman Jobs Dataflow.
Pilih tugas streaming Anda dari daftar tugas.
Di navigasi, klik Stop.
Dalam dialog Stop job, batalkan pipeline, lalu klik Stop job.
Menghapus topik dan langganan Pub/Sub
Di konsol Google Cloud, buka halaman Topics Pub/Sub.
Pilih topik
bigtable-change-stream-topic
.Klik Hapus dan konfirmasi.
Klik Langganan di sidebar.
Pilih langganan
bigtable-change-stream-topic-sub
.Klik Hapus dan konfirmasi.
Menghapus fungsi Cloud Run
Di konsol Google Cloud, buka fungsi Cloud Run.
Pilih fungsi
bt-ps-tutorial-function
.Klik Hapus dan konfirmasi.