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 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) pada 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 aliran perubahannya.

  3. Klik Tabel di panel kiri.

    Halaman Tables 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: jangka waktu 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 akan lagi ditagih 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 Tables 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 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 disimpan selama jumlah hari yang ditingkatkan 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 Tables 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: jangka waktu 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