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 Spanner Studio, Anda dapat menyimpan dan mengelola skrip SQL 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 membuat, mengedit, dan menghapus kueri tersimpan: Pengguna Kueri Studio (roles/databasesconsole.studioQueryUser)
• Untuk mengelola semua kueri tersimpan dalam project, termasuk akses ke halaman Kueri tersimpan: Admin Kueri Studio (roles/databasesconsole.studioQueryAdmin)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat 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 Spanner, lihat Ringkasan IAM.

Buat kueri yang disimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

1. Buka halaman Instances Spanner di konsol Google Cloud .
   Instance
2. Pilih instance tempat Anda ingin membuat kueri tersimpan.
3. Pilih database tempat Anda ingin membuat kueri tersimpan.
4. Di menu navigasi, klik Spanner Studio.
5. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.
6. Di editor kueri, masukkan kueri SQL.
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 Spanner 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 Spanner 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 Instances Spanner di konsol Google Cloud .
   Instance
2. Pilih instance apa pun. Karena kueri tersimpan adalah turunan dari project, selama Anda memiliki peran yang diperlukan, Anda dapat melihat semua kueri tersimpan dalam project dari instance atau database mana pun.

3. Pilih database apa pun.
4. Di panel Explorer pada halaman Spanner 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 Spanner Studio atau di halaman Kueri tersimpan di konsol Google Cloud .

1. Di panel Explorer pada halaman Spanner 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.