Mengonfigurasi aliran data perubahan

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

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

Untuk mendapatkan 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 data perubahan Bigtable, minta administrator untuk memberi Anda peran IAM berikut.

  • Administrator Bigtable (roles/bigtable.admin) pada instance Bigtable yang berisi tabel yang rencananya akan di-streaming perubahan dari

Mengaktifkan aliran data perubahan

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

Konsol

  1. Buka daftar instance Bigtable di Konsol Google Cloud.

    Membuka daftar instance

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

  3. Klik Tables di panel kiri.

    Halaman Tables menampilkan daftar tabel dalam instance.

  4. Klik Edit untuk tabel tempat Anda ingin mengaktifkan aliran data perubahan.

  5. Klik Aktifkan aliran data perubahan.

  6. Di kolom Waktu habis masa berlaku, masukkan angka dari 1 sampai 7 untuk mengonfigurasi jumlah hari kumpulan data 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 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 Bigtable harus menyimpan data aliran perubahan untuk tabel. Harus tidak kurang dari satu hari dan tidak lebih dari tujuh hari, yang dinyatakan sebagai angka dan huruf untuk unit. Unit yang dapat diterima adalah hari (d), jam (h), menit (m), dan detik (dtk). Contoh: 5d

Menonaktifkan aliran data perubahan

Anda dapat menonaktifkan aliran data perubahan tabel kapan saja. Kumpulan data aliran data yang dibuat sebelum Anda menonaktifkan aliran data 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 direkam sebelum streaming dinonaktifkan.

Konsol

  1. Buka daftar instance Bigtable di Konsol Google Cloud.

    Membuka daftar instance

  2. Klik instance yang tabelnya ingin Anda lihat.

  3. Klik Tables di panel kiri.

    Halaman Tables menampilkan daftar tabel dalam instance.

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

  5. Hapus tanda centang dari Aktifkan aliran data perubahan.

  6. Klik Simpan.

gcloud

Untuk menonaktifkan aliran data 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 saat Bigtable menyimpan data aliran data perubahan. Jika Anda mengurangi jumlah hari, kumpulan data yang di-streaming sebelum perubahan konfigurasi akan terus menggunakan penyimpanan hingga pemadatan berikutnya. Setelah perubahan konfigurasi, Anda hanya dapat mengalirkan perubahan dari jangka waktu yang baru ditentukan.

Jika Anda meningkatkan waktu retensi, hal tersebut tidak berlaku surut — aliran data perubahan disimpan selama peningkatan jumlah hari yang dimulai saat Anda mengubah konfigurasi.

Konsol

  1. Buka daftar instance Bigtable di Konsol Google Cloud.

    Membuka daftar instance

  2. Klik instance yang tabelnya ingin Anda lihat.

  3. Klik Tables di panel kiri.

    Halaman Tables menampilkan daftar tabel dalam instance.

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

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

  6. Klik Simpan.

gcloud

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

Langkah selanjutnya