Membuat dan mengelola kueri tersimpan

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 informasinya, lihat Ringkasan kueri tersimpan.

Kemampuan kueri tersimpan hanya tersedia di konsol Google Cloud.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan kueri tersimpan, minta administrator untuk memberi Anda peran IAM berikut pada project:

  • Untuk membuat dan menghapus kueri tersimpan: Pengguna Kueri Studio (roles/databasesConsole.studioQueryUser)
  • Untuk mengelola semua kueri tersimpan dalam project, termasuk akses ke halaman Kueri tersimpan: Studio Query Admin (roles/databasesConsole.studioQueryAdmin)

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

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk menggunakan kueri tersimpan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menggunakan kueri tersimpan:

  • Untuk membuat dan menghapus kueri tersimpan:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
  • Untuk mengelola semua kueri tersimpan dalam project:
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
    • databasesConsole.studioQuery.list
    • databasesConsole.studioQuery.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Peran Pengguna Kueri Studio (roles/databasesConsole.studioQueryUser) memberikan akses pembuatan, tampilan, dan penulisan kueri tersimpan. Jumlah ini cukup untuk sebagian besar pengguna.

Peran Studio Query Admin (roles/databasesConsole.studioQueryAdmin) hanya boleh diberikan kepada administrator. Untuk mengetahui informasi selengkapnya tentang Identity and Access Management (IAM) Spanner, lihat Ringkasan IAM.

Izin

Untuk membuat kueri tersimpan, Anda memerlukan izin IAM berikut di tingkat project:

  • databasesConsole.locations.get
  • databasesConsole.locations.list
  • databasesConsole.studioQueries.create

Untuk melihat kueri tersimpan, Anda memerlukan izin berikut di tingkat project:

  • databasesConsole.studioQueries.search

Untuk mengubah dan menghapus kueri tersimpan, Anda memerlukan izin berikut di tingkat project:

  • databasesConsole.studioQueries.update

Izin untuk menjalankan kueri diwarisi dari database. Anda mungkin memiliki izin untuk melihat, tetapi tidak dapat menjalankan kueri.

Buat kueri yang disimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

  1. Buka halaman Instance 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.

    1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.

  5. Di editor kueri, masukkan kueri SQL yang valid.

  6. Klik Simpan.

  7. Dalam dialog Simpan kueri, ketik nama untuk kueri tersimpan.

  8. Klik Simpan.

Membuka dan menjalankan kueri tersimpan

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

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.
  2. Di panel Explorer, buka bagian Queries. Klik kueri tersimpan untuk membukanya di tab editor baru. Atau, klik 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 halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.
  2. Di panel Explorer, buka bagian Queries. Klik kueri tersimpan untuk membukanya di tab editor baru. Atau, klik 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 Instance 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.

  4. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.

  5. Di panel Explorer, buka bagian Queries. 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 lain).

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

Untuk menghapus kueri tersimpan di halaman Kueri tersimpan, ikuti langkah-langkah berikut:

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

Menghapus kueri tersimpan

  1. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor kosong.
  2. Di panel Explorer, luaskan folder Kueri. 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.

Langkah berikutnya