Membuat dan mengelola kueri tersimpan

Untuk menggunakan kembali dan membagikan operasi database umum di seluruh sesi, Anda dapat membuat, mengatur, dan mengelola kueri tersimpan di Firebase console. 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 pada 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 lebih lanjut izin yang diperlukan, lihat Izin yang diperlukan.

Izin yang diperlukan

Untuk membuat, melihat, mengubah, dan menghapus kueri tersimpan, Anda memerlukan izin IAM berikut di level 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 IAM Cloud Firestore, lihat Identity and Access Management .

Membuat kueri tersimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

  1. Buka halaman Cloud Firestore di Firebase console.
    Cloud Firestore
  2. Pilih database tempat Anda ingin membuat kueri tersimpan. Database harus berupa instance edisi Enterprise.
  3. Klik tab editor kueri.
  4. Di editor kueri, masukkan kueri.
  5. Klik Save.
  6. Dalam dialog Save query, masukkan nama untuk kueri tersimpan.
  7. Klik Save.

Membuka dan menjalankan kueri tersimpan

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

  1. Di editor kueri, klik kueri tersimpan ().
  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 editor kueri, klik kueri tersimpan ().
  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:

Di Konsol Google Cloud, buka halaman kueri tersimpan.

Buka Kueri tersimpan

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

Menghapus kueri tersimpan

Anda dapat menghapus kueri tersimpan dari halaman Cloud Firestore Studio atau di halaman Saved queries di Konsol Google Cloud.

  1. Di editor kueri, klik kueri tersimpan ().
  2. Klik Lihat tindakan di samping kueri tersimpan yang ingin Anda hapus. Kemudian, untuk menghapus kueri tersimpan, klik Delete query.
  3. Pada dialog Delete query, klik Delete.

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

  1. Buka halaman kueri tersimpan.
  2. Klik Lihat tindakan di samping kueri tersimpan yang ingin Anda hapus.
  3. Klik Delete query untuk menghapus kueri tersimpan.
  4. Pada dialog Delete query, klik Delete.

Langkah berikutnya