Membuat dan mengelola kueri tersimpan

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

Kemampuan kueri tersimpan hanya tersedia di konsol Google Cloud.

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: Cloud Datastore Viewer (roles/datastore.viewer)
  • Untuk melihat, membuat, mengubah, dan menghapus kueri tersimpan: Cloud Datastore User (roles/datastore.user)
  • Untuk mengelola, melihat, membuat, mengubah, dan menghapus kueri tersimpan: Cloud Datastore Owner (roles/datastore.owner). Peran ini memiliki izin yang luas dan memberikan akses penuh ke Cloud Firestore, hanya untuk digunakan oleh administrator.

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

Peran yang telah ditetapkan 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 Studio Query User (roles/databasesconsole.studioQueryUser) memberikan akses untuk membuat, melihat, dan menulis kueri tersimpan. Peran ini memenuhi kebutuhan sebagian besar pengguna.

Berikan peran Studio Query Admin (roles/databasesconsole.studioQueryAdmin) hanya kepada administrator. Untuk mengetahui informasi selengkapnya tentang Cloud Firestore IAM, lihat Identity and Access Management .

Membuat kueri tersimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

  1. Buka halaman All databases di konsol Google Cloud.
    Semua database
  2. Pilih database Cloud Firestore tempat Anda ingin membuat kueri tersimpan.
  3. Di menu navigasi, klik Cloud Firestore Studio.
  4. Di panel Explorer di halaman Cloud Firestore Studio, buka bagian Collections.
  5. Klik koleksi untuk membuka tab editor baru. Secara opsional, Anda dapat mengklik View actions di samping koleksi. Kemudian, klik Query collection untuk membuka tab editor baru.
  6. Di editor kueri, masukkan kueri.
  7. Klik Save.
  8. Di dialog Save query, masukkan nama untuk kueri tersimpan.
  9. Klik Save.

Membuka dan menjalankan kueri tersimpan

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

  1. Di panel Explorer di halaman Cloud Firestore Studio, buka bagian Queries.
  2. Klik kueri tersimpan untuk membukanya di tab editor baru. Secara opsional, 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 di halaman Cloud Firestore Studio, buka bagian Queries.
  2. Klik kueri tersimpan untuk membukanya di tab editor baru. Secara opsional, 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. Buka halaman All databases di konsol Google Cloud.
    Semua database
  2. Pilih database apa pun. Karena kueri tersimpan adalah turunan dari project, selama Anda memiliki peran yang diperlukan, Anda dapat melihat semua kueri tersimpan di project dari database mana pun.
  1. Pilih database apa pun.
  2. Di panel Explorer di halaman Cloud Firestore Studio, buka bagian Queries.
  3. 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 Cloud Firestore Studio atau di halaman Saved queries di konsol Google Cloud.

  1. Di panel Explorer di halaman Cloud Firestore 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. Di 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. Di dialog Delete query, klik Delete.

Langkah berikutnya