Mengonfigurasi aliran data perubahan

Jika ingin melacak perubahan data yang dilakukan pada tabel Bigtable, Anda dapat mengaktifkan aliran perubahan untuk tabel tersebut, lalu membacanya menggunakan aplikasi seperti Dataflow. Sebelum membaca dokumen ini, baca Ringkasan aliran perubahan. Secara khusus, pastikan Anda mengetahui biaya yang dikeluarkan saat melakukan streaming perubahan.

Halaman ini menjelaskan cara mengaktifkan, menonaktifkan, dan mengubah periode retensi data untuk aliran perubahan.

Untuk mengetahui petunjuk tentang cara membuat tabel baru dengan aliran perubahan yang diaktifkan, lihat Membuat tabel.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengaktifkan, menonaktifkan, atau mengubah aliran perubahan Bigtable, minta administrator Anda untuk memberi Anda peran IAM berikut.

• Bigtable Administrator (roles/bigtable.admin) di instance Bigtable yang berisi tabel yang ingin Anda streaming perubahannya

Mengaktifkan aliran perubahan

Untuk mengaktifkan aliran perubahan pada tabel yang ada, selesaikan langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang berisi tabel yang ingin Anda aktifkan aliran perubahannya.

3. Klik Tabel di panel kiri.

   Halaman Tabel menampilkan daftar tabel dalam instance.

4. Klik Edit untuk tabel yang ingin Anda aktifkan aliran perubahannya.

5. Klik Aktifkan aliran perubahan.

6. Di kolom Waktu habis masa berlaku, masukkan angka dari 1 hingga 7 untuk mengonfigurasi jumlah hari rekaman aliran data harus dipertahankan.

7. Klik Simpan.

gcloud

Untuk mengaktifkan aliran perubahan pada tabel, gunakan perintah gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Ganti kode berikut:

• TABLE_ID: ID tabel yang perubahannya ingin Anda streaming
• INSTANCE_ID: instance yang berisi tabel
• PROJECT_ID: project yang berisi instance
• CHANGE_STREAM_RETENTION_PERIOD: durasi waktu yang Bigtable harus menyimpan data aliran perubahan untuk tabel. Tidak boleh kurang dari satu hari dan tidak boleh lebih dari tujuh hari, dinyatakan sebagai angka dan huruf untuk satuan. Unit yang dapat diterima adalah hari (d), jam (h), menit (m), dan detik (s). Contoh: 5d

Menonaktifkan aliran perubahan

Anda dapat menonaktifkan aliran perubahan tabel kapan saja. Rekaman aliran data yang dibuat sebelum Anda menonaktifkan aliran perubahan akan terus menggunakan penyimpanan hingga pemadatan berikutnya, tetapi Anda tidak lagi dikenai biaya untuk penyimpanan tersebut. Anda tidak dapat membaca aliran perubahan setelah menonaktifkannya, termasuk perubahan yang dicatat sebelum Anda menonaktifkan aliran.

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tabel di panel kiri.

   Halaman Tabel menampilkan daftar tabel dalam instance.

4. Klik Edit untuk tabel yang konfigurasi aliran perubahannya ingin Anda nonaktifkan.

5. Hapus tanda centang dari Aktifkan aliran perubahan.

6. Klik Simpan.

gcloud

Untuk menonaktifkan aliran perubahan pada tabel, gunakan perintah gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-change-stream-retention-period

Ganti kode berikut:

• TABLE_ID: ID tabel yang perubahannya ingin Anda streaming
• INSTANCE_ID: instance yang berisi tabel
• PROJECT_ID: project yang berisi instance

Mengubah waktu retensi aliran perubahan

Anda dapat mengubah jumlah hari Bigtable menyimpan catatan aliran data perubahan. Jika Anda mengurangi jumlah hari, rekaman yang di-streaming sebelum perubahan konfigurasi akan terus menggunakan penyimpanan hingga pemadatan berikutnya. Setelah perubahan konfigurasi, Anda hanya dapat melakukan streaming perubahan dari jangka waktu yang baru ditentukan.

Jika Anda meningkatkan waktu retensi, hal ini tidak berlaku surut — aliran perubahan dipertahankan selama jumlah hari yang ditingkatkan mulai saat Anda mengubah konfigurasi.

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tabel di panel kiri.

   Halaman Tabel menampilkan daftar tabel dalam instance.

4. Klik Edit untuk tabel yang konfigurasi aliran perubahannya ingin Anda ubah.

5. Di kolom Waktu habis masa berlaku, masukkan angka dari 1 hingga 7 untuk jumlah hari data stream harus dipertahankan.

6. Klik Simpan.

gcloud

Untuk mengubah periode retensi aliran perubahan tabel, gunakan perintah gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Ganti kode berikut:

• TABLE_ID: ID tabel yang perubahannya ingin Anda streaming
• INSTANCE_ID: instance yang berisi tabel
• PROJECT_ID: project yang berisi instance
• CHANGE_STREAM_RETENTION_PERIOD: durasi waktu yang Bigtable harus menyimpan data aliran perubahan untuk tabel. Harus dari satu hingga tujuh hari, dinyatakan sebagai angka dan huruf untuk satuannya. Unit yang dapat diterima adalah hari (d), jam (h), menit (m), dan detik (s). Contoh: 5d

Langkah berikutnya

• Membaca aliran perubahan dengan Dataflow.
• Tinjau harga Bigtable.
• Selesaikan panduan memulai untuk mempelajari cara mengaktifkan aliran perubahan dan melihat perubahan.
• Gunakan library klien Cloud Bigtable untuk Java guna membaca aliran perubahan.
• Ikuti tutorial tentang memproses aliran perubahan.