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 Google Cloud konsol, atau library klien Bigtable untuk Java dan Go.
Sebelum memulai
Ikuti langkah-langkah berikut jika Anda berencana menggunakan gcloud CLI.
-
Instal Google Cloud CLI.
-
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
-
Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:
gcloud init
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) pada instance.
Jika tidak, minta izin berikut di tingkat instance, bergantung pada operasi yang ingin Anda lakukan:
- Buat:
bigtable.materializedViews.create - Perbarui:
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 hal berikut:
- Opsional: Sebagai praktik terbaik, aktifkan penskalaan otomatis untuk cluster di instance Anda guna memastikan cluster dapat melakukan penskalaan jika diperlukan saat Bigtable memproses dan menyinkronkan tampilan terwujud berkelanjutan dan untuk menangani penggunaan penyimpanan tambahan.
- Identifikasi tabel Bigtable yang memiliki izin untuk dibaca guna digunakan sebagai sumber untuk tampilan terwujud berkelanjutan.
- Siapkan kueri SQL yang menentukan tampilan terwujud berkelanjutan Anda. Untuk persyaratan kueri, lihat Kueri tampilan terwujud berkelanjutan 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
Buka daftar instance Bigtable di Google Cloud konsol.
Pilih instance.
Di panel navigasi, klik Bigtable Studio.
Buka tab baru dengan mengklik dan lalu memilih Editor.
Saat editor kueri muncul, tulis kueri Anda. Jika kueri adalah SQL yang valid, pesan Valid akan ditampilkan.
Opsional: Untuk memformat pernyataan Anda dalam gaya SQL, klik Format.
Klik Run. Hasil kueri Anda akan muncul di tabel Results.
Jika Anda puas dengan kueri tersebut, klik panah pengembang Save as dan pilih Save as materialized view.
Di dialog Save your materialized view, masukkan nama untuk tampilan, lalu klik Save.
Untuk mengetahui informasi selengkapnya tentang penggunaan 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: untuk mengaktifkan perlindungan penghapusan untuk tampilan terwujud berkelanjutan, tambahkan perintah dengan hal berikut:
--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 perlu mengubah kueri, Anda harus menghapus tampilan terwujud berkelanjutan, lalu membuat tampilan 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 bigtable materialized-views update command.
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 perbaruiINSTANCE: ID instance yang berisi tampilan terwujud berkelanjutanDELETION_PROTECTION:trueataufalse
Menghapus tampilan terwujud berkelanjutan
Anda dapat menghapus tampilan terwujud berkelanjutan yang tidak mengaktifkan perlindungan penghapusan. Anda tidak dapat mengurungkan operasi ini.
Konsol
Buka daftar instance Bigtable di Google Cloud konsol.
Pilih instance dari daftar.
Di panel navigasi, klik Bigtable Studio.
Luaskan Materialized views.
Di samping tampilan yang ingin Anda hapus, klik menu tindakan more_vert, lalu klik Delete.
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 hapusINSTANCE: ID instance yang berisi tampilan terwujud berkelanjutan
Mendapatkan daftar tampilan terwujud berkelanjutan
Anda dapat melihat daftar tampilan terwujud berkelanjutan untuk sebuah instance.
Konsol
Buka daftar instance Bigtable di Google Cloud konsol.
Pilih instance dari daftar.
Di panel navigasi, klik Bigtable Studio. Daftar tampilan terwujud berkelanjutan akan ditampilkan.
Opsional: 10 tampilan pertama dalam instance akan dicantumkan. Untuk melihat 10 tampilan lainnya, klik Show more.
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.