Membuat dan mengelola kueri tersimpan

Halaman ini menjelaskan cara membuat dan mengelola kueri tersimpan. Saat menulis skrip SQL di Bigtable Studio, Anda dapat menyimpan dan mengelola skrip SQL tersebut. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kueri tersimpan.

Kemampuan kueri tersimpan hanya tersedia di konsol, dan tidak menggunakan API.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menggunakan kueri tersimpan, minta administrator untuk memberi Anda peran Identity and Access Management (IAM) berikut di project:

  • Untuk melihat kueri tersimpan: Bigtable Reader (roles/bigtable.reader)
  • Untuk melihat, membuat, mengubah, dan menghapus kueri tersimpan: Bigtable User (roles/bigtable.user)
  • Untuk mengelola, melihat, membuat, mengubah, dan menghapus kueri tersimpan: Bigtable Admin (roles/bigtable.admin). Peran ini memiliki izin yang luas dan memberikan akses penuh ke Bigtable, hanya untuk digunakan oleh administrator.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk menggunakan kueri tersimpan. Untuk mempelajari izin yang diperlukan lebih lanjut, lihat Izin yang diperlukan.

Izin yang diperlukan

Untuk membuat, melihat, mengubah, dan menghapus kueri tersimpan, Anda memerlukan izin IAM berikut di tingkat project:

Tindakan Izin IAM yang diperlukan
Membuat kueri tersimpan
  • databasesconsole.studioQueries.create
Melihat kueri tersimpan
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
Mengubah kueri tersimpan
  • databasesconsole.studioQueries.update
Menghapus kueri tersimpan
  • databasesconsole.studioQueries.delete
Mengelola kueri tersimpan
(Hanya untuk digunakan oleh administrator)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

Anda juga bisa mendapatkan izin ini menggunakan peran khusus atau peran bawaan lainnya.

Peran Pengguna Kueri Studio (roles/databasesconsole.studioQueryUser) memberikan akses untuk membuat, melihat, dan menulis kueri tersimpan. Peran ini memenuhi kebutuhan sebagian besar pengguna.

Berikan peran Admin Kueri Studio (roles/databasesconsole.studioQueryAdmin) hanya kepada administrator. Untuk mengetahui informasi selengkapnya tentang Bigtable IAM, lihat Kontrol akses Bigtable dengan IAM.

Membuat kueri tersimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

  1. Di Google Cloud konsol, buka halaman Instance Bigtable.
    Instance
  2. Pilih instance tempat Anda ingin membuat kueri tersimpan.

  3. Di menu navigasi, klik Bigtable Studio.

    Panel Explorer menampilkan daftar tabel, tampilan, dan kueri di instance.

  4. Dari tab Editor, jalankan kueri Anda.

    Hasilnya akan muncul di tabel Results.

  5. Jika Anda tidak puas dengan hasilnya, ubah kueri dan eksekusi lagi. Jika Anda puas dengan kueri tersebut, klik Save.
  6. Dalam dialog Save query, masukkan nama untuk kueri tersimpan.
  7. Klik Save.

Opsional:

  • Untuk menyimpan kueri dengan nama yang berbeda, klik panah pengembang Save as , pilih Save as query, lalu masukkan nama baru dalam dialog.
  • Untuk mengubah region yang digunakan oleh kueri tersimpan ini, pilih Show advanced options. Kemudian, dari daftar Region, pilih region.

Anda juga dapat menyimpan kueri sebagai tampilan terwujud logis atau berkelanjutan.

Membuka dan menjalankan kueri tersimpan

Untuk membuka kueri tersimpan sebagai kueri baru, ikuti langkah-langkah berikut:

  1. Di panel Explorer pada halaman Bigtable Studio, buka bagian Queries.
  2. Klik kueri tersimpan untuk membukanya di tab editor baru. Atau, Anda dapat mengklik View actions di samping kueri tersimpan. Kemudian, klik Open query untuk membukanya di tab editor baru.
  3. Klik Run.

Memperbarui kueri tersimpan

Untuk memperbarui kueri tersimpan yang ada, ikuti langkah-langkah berikut:

  1. Di panel Explorer pada halaman Bigtable Studio, buka bagian Queries.
  2. Klik kueri tersimpan untuk membukanya di tab editor baru. Atau, Anda dapat mengklik View actions di samping kueri tersimpan. Kemudian, klik Open query untuk membukanya di tab editor baru.
  3. Ubah kueri.
  4. Untuk menyimpan kueri yang diubah, klik Save.

Melihat dan mengelola daftar semua kueri tersimpan

Untuk melihat daftar semua kueri tersimpan di project Anda, ikuti langkah-langkah berikut:

  1. Di Google Cloud konsol, buka halaman Instance Bigtable.
    Instance
  2. Pilih instance. Karena kueri tersimpan adalah turunan project, selama Anda memiliki peran yang diperlukan, Anda dapat melihat semua kueri tersimpan di project dari instance atau database mana pun.
  1. Di panel Explorer pada halaman Bigtable Studio, buka bagian Queries.
  2. Klik View actions di samping kueri tersimpan. Kemudian, klik Manage queries.

    Halaman Saved queries akan terbuka. Halaman ini mencantumkan semua kueri tersimpan di project ini, termasuk kueri tersimpan untuk produk lainnya Google Cloud .

Anda dapat menelusuri, memfilter, melihat, dan menghapus kueri di halaman Saved queries. Anda tidak dapat mengedit kueri yang ada di halaman Saved queries.

Menghapus kueri tersimpan

Anda dapat menghapus kueri tersimpan dari halaman Bigtable Studio atau di halaman Saved queries di Google Cloud konsol.

  1. Di panel Explorer pada halaman Bigtable Studio, buka bagian Queries.
  2. Klik View actions di samping kueri tersimpan yang ingin Anda hapus. Kemudian, untuk menghapus kueri tersimpan, klik Delete query.
  3. Dalam dialog Delete query, klik Delete.

Anda juga dapat menghapus kueri tersimpan di halaman Saved queries. Untuk menghapus kueri tersimpan di halaman Saved queries, ikuti langkah-langkah berikut:

  1. Buka halaman Saved queries.
  2. Klik View actions di samping kueri tersimpan yang ingin Anda hapus.
  3. Klik Delete query untuk menghapus kueri tersimpan.
  4. Dalam dialog Delete query, klik Delete.

Langkah berikutnya