Membuat dan mengelola kueri tersimpan

Membuat dan mengelola kueri tersimpan

Pratinjau

Fitur ini tunduk kepada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara membuat dan mengelola kueri tersimpan. Saat menulis kueri di 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 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 Firestore dengan kompatibilitas MongoDB, hanya untuk digunakan oleh administrator.

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, baca artikel Mengelola akses ke project, folder, dan organisasi.

Peran bawaan 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 tingkat project:

Tindakan	Izin IAM yang diperlukan
Membuat kueri tersimpan	databasesconsole.studioQueries.create
Lihat 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

Catatan: Memiliki akses ke kueri tersimpan tidak otomatis berarti Anda memiliki izin untuk menjalankan kueri.

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 IAM kompatibilitas MongoDB Firestore, lihat Identity and Access Management.

Buat kueri yang disimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

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

Membuka dan menjalankan kueri tersimpan

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

1. Di panel Explorer pada halaman Firestore Studio, buka bagian Queries.
2. Klik kueri tersimpan untuk membukanya di tab editor baru. Secara opsional, Anda dapat mengklik Lihat tindakan 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 Firestore Studio, buka bagian Queries.
2. Klik kueri tersimpan untuk membukanya di tab editor baru. Secara opsional, Anda dapat mengklik Lihat tindakan di samping kueri tersimpan. Kemudian, klik Open query untuk membukanya di tab editor baru.
3. Ubah kueri.
4. Untuk menyimpan kueri yang diubah, klik Simpan.

Melihat dan mengelola daftar semua kueri tersimpan

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

1. Buka halaman Semua database di konsol Google Cloud .
   Semua database
2. Pilih database. Karena kueri tersimpan adalah turunan dari project, selama Anda memiliki peran yang diperlukan, Anda dapat melihat semua kueri tersimpan dalam project dari database mana pun.

3. Pilih database.
4. Di panel Explorer pada halaman Firestore Studio, buka bagian Queries.
5. Klik Lihat tindakan di samping kueri tersimpan. Kemudian, klik Kelola kueri.

   Halaman Kueri tersimpan akan terbuka. Halaman ini mencantumkan semua kueri tersimpan dalam project ini, termasuk kueri tersimpan untuk produk Google Cloud lainnya.

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 Firestore Studio atau di halaman Saved queries di konsol Google Cloud .

1. Di panel Explorer pada halaman Firestore Studio, buka bagian Queries.
2. Klik Lihat tindakan di samping kueri tersimpan yang ingin Anda hapus. Kemudian, klik Hapus kueri untuk menghapus kueri tersimpan.
3. Pada dialog Hapus kueri, klik Hapus.

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

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

Langkah berikutnya

• Pelajari kueri tersimpan.