Membuat dan mengelola kueri tersimpan

Pratinjau

Fitur ini tunduk pada "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 skrip SQL di AlloyDB Studio , Anda dapat menyimpan dan mengelola skrip SQL tersebut. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kueri tersimpan .

Kemampuan kueri tersimpan hanya tersedia di Google Cloud konsol.

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: Pengguna Database Cloud AlloyDB (roles/alloydb.databaseuser)
• Untuk membuat, mengedit, melihat, dan menghapus kueri tersimpan di project, termasuk akses ke halaman Kueri tersimpan: Admin Cloud AlloyDB (roles/alloydb.admin) atau Pengguna Kueri Studio (roles/databasesconsole.studioQueryUser)
• Untuk mengelola semua kueri tersimpan di project, termasuk akses ke halaman Kueri tersimpan: Admin Kueri Studio (roles/databasesconsole.studioQueryAdmin)

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

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 AlloyDB, lihat Peran dan izin untuk AlloyDB .

Membuat kueri tersimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Clusters.
   Buka Clusters
2. Pilih instance tempat Anda ingin membuat kueri tersimpan.
3. Di menu navigasi, klik AlloyDB Studio.
4. Di halaman AlloyDB Studio, klik New tab atau gunakan tab editor kosong.
5. Di editor kueri, masukkan kueri SQL.
6. Klik Save.
7. Di dialog Save query, masukkan nama untuk kueri tersimpan.
8. Klik Save.

Membuka dan menjalankan kueri tersimpan

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

1. Di panel Explorer di halaman AlloyDB 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 AlloyDB 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. Di Google Cloud konsol, buka halaman Clusters.
   Buka Clusters
2. Pilih cluster. Karena kueri tersimpan adalah turunan dari project, selama Anda memiliki peran yang diperlukan, Anda dapat melihat semua kueri tersimpan di project dari cluster, instance, atau database mana pun.
3. Di menu navigasi, klik AlloyDB Studio dan lakukan autentikasi.

3. Pilih database.
4. Di panel Explorer di halaman AlloyDB Studio, buka bagian Queries.
5. 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 lain 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 AlloyDB Studio atau di halaman Saved queries di Google Cloud konsol.

1. Di panel Explorer di halaman AlloyDB 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

• Pelajari tentang kueri tersimpan.