Mengonfigurasi aliran data perubahan

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

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

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengaktifkan, menonaktifkan, atau mengubah streaming perubahan Bigtable, minta administrator 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. Buka daftar instance Bigtable di konsol Google Cloud.

    Buka daftar instance

  2. Klik instance yang berisi tabel yang ingin Anda aktifkan streaming 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 data perubahan.

  6. Di kolom Expiration time, masukkan angka dari 1 hingga 7 untuk mengonfigurasi jumlah hari yang harus disimpan untuk data stream.

  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 untuk 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 harus dipertahankan Bigtable untuk data aliran perubahan tabel. Harus tidak kurang dari satu hari dan tidak lebih dari tujuh hari, yang 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. Data stream yang dibuat sebelum Anda menonaktifkan aliran perubahan akan terus menggunakan penyimpanan hingga pengompresian 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. Buka daftar instance Bigtable di konsol Google Cloud.

    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 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 untuk tabel yang perubahannya ingin Anda streaming
  • INSTANCE_ID: instance yang berisi tabel
  • PROJECT_ID: project yang berisi instance

Mengubah waktu retensi aliran data perubahan

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

Jika Anda meningkatkan waktu retensi, perubahan tersebut tidak bersifat retroaktif — aliran perubahan akan disimpan selama jumlah hari yang meningkat mulai saat Anda mengubah konfigurasi.

Konsol

  1. Buka daftar instance Bigtable di konsol Google Cloud.

    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 yang akan dipertahankan data stream.

  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 untuk 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 harus dipertahankan Bigtable untuk data aliran perubahan tabel. Harus antara satu hingga tujuh hari, yang dinyatakan sebagai angka dan huruf untuk unit. Unit yang dapat diterima adalah hari (d), jam (h), menit (m), dan detik (s). Contoh: 5d

Langkah selanjutnya