Membuat dan mengelola tampilan terwujud berkelanjutan

Dokumen ini menjelaskan cara membuat dan melakukan operasi pada tampilan terwujud berkelanjutan di Bigtable. Sebelum membaca dokumen ini, baca ringkasannya di Tampilan terwujud berkelanjutan.

Anda dapat membuat tampilan terwujud berkelanjutan menggunakan Google Cloud CLI, editor kueri Bigtable Studio di konsol Google Cloud , atau library klien Bigtable untuk Java dan Go.

Sebelum memulai

Lakukan langkah-langkah berikut jika Anda berencana menggunakan gcloud CLI.

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat dan mengelola tampilan terwujud berkelanjutan, minta administrator untuk memberi Anda peran Bigtable Admin (roles/bigtable.admin) di instance. Jika tidak, minta izin berikut di tingkat instance, bergantung pada operasi yang ingin Anda lakukan:

  • Buat: bigtable.materializedViews.create
  • Update: bigtable.materializedViews.update
  • Hapus: bigtable.materializedViews.delete
  • Daftar: bigtable.materializedViews.list

Untuk membuat tampilan terwujud berkelanjutan, Anda juga harus memiliki setidaknya izin bigtable.tables.readRows pada tabel sumber.

Untuk melihat semua peran dan izin yang tersedia, lihat Kontrol akses Bigtable dengan IAM.

Membuat tampilan terwujud berkelanjutan

Sebelum membuat tampilan terwujud berkelanjutan, lakukan langkah berikut:

  • Opsional: Sebagai praktik terbaik, aktifkan penskalaan otomatis untuk cluster di instance Anda guna memastikan cluster dapat di-scale up jika diperlukan saat Bigtable memproses dan menyinkronkan tampilan terwujud berkelanjutan serta menangani penggunaan penyimpanan tambahan.
  • Identifikasi tabel Bigtable yang izin membacanya Anda miliki untuk digunakan sebagai sumber tampilan terwujud berkelanjutan.
  • Siapkan kueri SQL yang menentukan tampilan terwujud berkelanjutan Anda. Untuk persyaratan kueri, lihat Kueri tampilan terwujud berkelanjutan.

Setelah Anda membuat tampilan terwujud berkelanjutan, mungkin perlu waktu beberapa menit agar tampilan tersebut menjadi aktif dan dapat dikueri. Anda dapat melihat metrik untuk tampilan guna memantau progresnya.

Konsol

  1. Buka daftar instance Bigtable di konsol Google Cloud .

    Buka daftar instance

  2. Pilih instance.

  3. Di panel navigasi, klik Bigtable Studio.

  4. Buka tab baru dengan mengklik , lalu pilih Editor.

    1. Saat editor kueri muncul, tulis kueri Anda. Jika kueri adalah SQL yang valid, pesan Valid akan ditampilkan.

    2. Opsional: Untuk memformat pernyataan Anda dalam gaya SQL, klik Format.

    3. Klik Run. Hasil kueri Anda akan muncul di tabel Results.

    4. Jika Anda sudah puas dengan kueri tersebut, klik Simpan, lalu pilih Tabel virtual.

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan editor kueri, lihat Mengelola data menggunakan Bigtable Studio.

gcloud

Untuk membuat tampilan terwujud berkelanjutan, gunakan perintah gcloud beta bigtable materialized-views create:

    gcloud beta bigtable materialized-views create VIEW \
            --instance=INSTANCE --query=QUERY

Ganti kode berikut:

  • VIEW: ID unik untuk tampilan terwujud berkelanjutan. Anda menggunakan ID ini sebagai ID tabel saat membuat kueri tampilan terwujud berkelanjutan.
  • INSTANCE: ID instance untuk membuat tampilan terwujud berkelanjutan. Harus merupakan instance yang sama dengan tabel sumber.
  • QUERY: pernyataan SQL yang valid yang menentukan tampilan terwujud berkelanjutan.

Opsional: untuk mengaktifkan perlindungan penghapusan untuk tampilan terwujud berkelanjutan, tambahkan perintah dengan berikut ini:

--deletion-protection=DELETION_PROTECTION

Ganti DELETION_PROTECTION dengan true atau false.

Memperbarui tampilan terwujud berkelanjutan

Anda dapat memperbarui perlindungan penghapusan untuk tampilan terwujud berkelanjutan. Anda tidak dapat memperbarui kueri SQL yang menentukan tampilan terwujud berkelanjutan; jika Anda perlu mengubah kueri, Anda harus menghapus tampilan terwujud berkelanjutan, lalu membuat yang baru yang menyertakan perubahan Anda.

Konsol

Anda tidak dapat memperbarui tampilan terwujud berkelanjutan di konsol. Sebagai gantinya, gunakan gcloud CLI.

gcloud

Untuk mengaktifkan atau menonaktifkan perlindungan penghapusan untuk tampilan terwujud berkelanjutan, gunakan perintah gcloud beta bigtable materialized-views update command.

gcloud beta bigtable materialized-views update VIEW \
        -–instance=INSTANCE --deletion-protection=DELETION_PROTECTION

Ganti kode berikut:

  • VIEW: ID unik untuk tampilan terwujud berkelanjutan yang ingin Anda perbarui
  • INSTANCE: ID instance yang berisi tampilan terwujud berkelanjutan
  • DELETION_PROTECTION: true atau false

Menghapus tampilan terwujud berkelanjutan

Anda dapat menghapus tampilan terwujud berkelanjutan yang tidak mengaktifkan perlindungan penghapusan. Anda tidak dapat mengurungkan operasi ini.

Konsol

  1. Buka daftar instance Bigtable di konsol Google Cloud .

    Buka daftar instance

  2. Pilih instance dari daftar.

  3. Di panel navigasi, klik Bigtable Studio.

  4. Luaskan Tabel virtual terwujud.

  5. Di samping tampilan yang ingin Anda hapus, klik menu tindakan more_vert, lalu klik Hapus.

gcloud

Untuk menghapus tampilan terwujud berkelanjutan, gunakan perintah gcloud beta bigtable materialized-views delete:

gcloud beta bigtable materialized-views delete VIEW \
      --instance=INSTANCE

Ganti kode berikut:

  • VIEW: ID unik untuk tampilan terwujud berkelanjutan yang ingin Anda hapus
  • INSTANCE: ID instance yang berisi tampilan terwujud berkelanjutan

Mendapatkan daftar tampilan terwujud berkelanjutan

Anda dapat melihat daftar tampilan terwujud berkelanjutan untuk sebuah instance.

Konsol

  1. Buka daftar instance Bigtable di konsol Google Cloud .

    Buka daftar instance

  2. Pilih instance dari daftar.

  3. Di panel navigasi, klik Bigtable Studio. Daftar tampilan terwujud berkelanjutan akan ditampilkan.

  4. Opsional: 10 tampilan pertama di instance dicantumkan. Untuk melihat 10 lainnya, klik Tampilkan lebih banyak.

gcloud

Untuk mencantumkan semua tampilan terwujud berkelanjutan untuk sebuah instance, gunakan perintah gcloud bigtable materialized-views list.

gcloud bigtable materialized-views list --instance=INSTANCE

Ganti INSTANCE dengan ID instance.

Langkah berikutnya