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 ringkasan 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

Jika Anda berencana menggunakan gcloud CLI, lakukan langkah-langkah berikut:

1. Instal Google Cloud CLI.

   Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.

2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

3. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

   gcloud init

   Catatan: Anda dapat menjalankan gcloud CLI di konsol Google Cloud tanpa menginstal Google Cloud CLI. Untuk menjalankan gcloud CLI di konsol Google Cloud , gunakan Cloud Shell.

Jika gcloud CLI menampilkan pesan Method not found, jalankan kembali perintah gcloud auth login.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat dan mengelola tampilan terwujud berkelanjutan, minta administrator untuk memberi Anda peran Admin Bigtable (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 Anda membuat tampilan terwujud berkelanjutan, lakukan hal berikut:

• Opsional: Sebagai praktik terbaik, aktifkan penskalaan otomatis untuk cluster di instance Anda guna memastikan cluster dapat ditingkatkan skalanya jika diperlukan saat Bigtable memproses dan menyinkronkan tampilan terwujud yang berkelanjutan serta menangani penggunaan penyimpanan tambahan.
• Opsional: Tentukan apakah Anda ingin tampilan terwujud berkelanjutan tersedia di semua cluster, atau apakah Anda ingin mengisolasi ketersediaan pemrosesan dan pembuatan kuerinya ke satu cluster. Untuk mengetahui informasi selengkapnya, lihat Fungsi SQL non-deterministik.
• Identifikasi tabel Bigtable yang izin bacanya 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.

Konsol

Catatan: Untuk membuat tampilan terwujud berkelanjutan yang diisolasi ke satu cluster, gunakan gcloud CLI.

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

   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 panah peluas Simpan sebagai dan pilih Simpan sebagai tampilan terwujud.

5. Dalam dialog Simpan tampilan terwujud Anda, masukkan nama untuk tampilan tersebut, lalu klik Simpan.

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

gcloud

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

    gcloud 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: Aktifkan proteksi dari penghapusan

Untuk mengaktifkan proteksi dari penghapusan untuk tampilan terwujud berkelanjutan, tambahkan perintah dengan --deletion-protection=DELETION_PROTECTION. Ganti DELETION_PROTECTION dengan true atau false.

Opsional: Membuat tampilan yang diisolasi ke satu cluster

Secara default, Bigtable mereplikasi tampilan terwujud berkelanjutan di semua cluster dalam instance. Untuk menyimpan tampilan hanya di cluster tertentu, tentukan tampilan Anda dengan CLUSTER_ATTRIBUTE dan teruskan flag --ignore-warnings:

gcloud bigtable materialized-views create VIEW \
  --instance=INSTANCE \
  --query="SELECT ... WHERE CLUSTER_ATTRIBUTE('cluster_id') = 'CLUSTER_ID'" \
  --ignore-warnings

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.
• CLUSTER_ID: ID cluster tempat Anda ingin mempertahankan tampilan.

Karena CLUSTER_ATTRIBUTE menghasilkan hasil yang berbeda di seluruh klaster, Anda harus menyertakan tanda --ignore-warnings untuk mengonfirmasi perbedaan tersebut. Untuk mengetahui informasi selengkapnya tentang sintaksis dan persyaratan kueri, lihat Mengisolasi tampilan ke satu cluster.

Membuat kueri tampilan terwujud berkelanjutan

Setelah tampilan terwujud berkelanjutan aktif, Anda dapat mengkuerinya seperti tabel lainnya menggunakan Bigtable Studio di konsol Google Cloud , atau library klien yang didukung. Untuk mengetahui informasi selengkapnya tentang sintaksis dan persyaratan kueri, lihat Kueri tampilan terwujud berkelanjutan.

Untuk menguji dan membuat kueri tampilan sebelum pengisian awal selesai, gunakan petunjuk kueri @{allow_incomplete_view=true}. Untuk mengetahui informasi selengkapnya, lihat Membaca data selama pengisian awal.

Memperbarui tampilan terwujud berkelanjutan

Anda dapat memperbarui proteksi dari penghapusan untuk tampilan terwujud berkelanjutan. Anda tidak dapat memperbarui kueri SQL yang menentukan tampilan terwujud berkelanjutan; jika perlu mengubah kueri, Anda harus menghapus tampilan terwujud berkelanjutan, lalu membuat tampilan terwujud berkelanjutan 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 proteksi dari penghapusan untuk tampilan terwujud berkelanjutan, gunakan perintah gcloud bigtable materialized-views update.

gcloud 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 proteksi dari penghapusan. Anda tidak dapat mengurungkan operasi ini.

Konsol

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

   Buka daftar instance

2. Pilih instance dari daftar.

3. Di panel navigasi, klik Bigtable Studio.

4. Luaskan Tampilan 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 bigtable materialized-views delete:

gcloud 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. Di konsol Google Cloud , buka daftar instance Bigtable.

   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

• Kueri tampilan terwujud berkelanjutan
• Tabel dan tampilan