Mengelola kueri tersimpan

Dokumen ini menjelaskan cara mengelola kueri tersimpan dan kueri tersimpan klasik.

Kueri tersimpan

Gunakan bagian berikut untuk mempelajari cara mengelola kueri tersimpan. Kueri tersimpan adalah aset kode BigQuery Studio yang didukung oleh Dataform.

Penting: Pada Maret 2024, API yang mendukung kemampuan BigQuery Studio akan otomatis diaktifkan untuk semua project BigQuery. Untuk mengetahui informasi selengkapnya, lihat Pengaktifan otomatis API BigQuery Studio.

Izin yang diperlukan

Untuk mengelola kueri tersimpan, Anda memerlukan peran Identity and Access Management (IAM) berikut:

• Pengguna Pekerjaan BigQuery (roles/bigquery.jobUser)
• Pengguna Sesi Bacaan BigQuery (roles/bigquery.readSessionUser)
• Pemilik Kode (roles/dataform.codeOwner)

Untuk mengetahui informasi selengkapnya tentang IAM BigQuery, lihat Kontrol akses dengan IAM.

Memberikan akses ke kueri tersimpan

Untuk memberi pengguna lain akses ke kueri tersimpan, tambahkan pengguna tersebut ke peran IAM yang sesuai.

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Temukan kueri tersimpan yang ingin Anda beri akses.

3. Klik Lihat tindakan di samping kueri tersimpan, lalu klik Bagikan > Kelola Izin.

4. Di panel Manage permissions, klik Add user/group.

5. Di kolom New principals, masukkan akun utama.

6. Dalam daftar Peran, pilih salah satu peran berikut:

   • Pemilik Kode: Dapat melakukan tindakan apa pun pada kueri tersimpan, termasuk menghapus atau membagikannya.
   • Editor Kode: Dapat mengedit kueri.
   • Peninjau Kode: Dapat melihat kueri.
   Catatan: Akun utama juga harus memiliki peran Pengguna BigQuery (roles/bigquery.user) untuk menjalankan kueri tersimpan.

7. Opsional: Untuk melihat daftar lengkap peran dan setelan berbagi lanjutan, klik Berbagi lanjutan.

8. Klik Save.

9. Untuk kembali ke info kueri tersimpan, klik Tutup.

Membagikan kueri tersimpan

Anda dapat membagikan kueri tersimpan kepada pengguna lain dengan membuat dan membagikan link ke kueri tersimpan tersebut. Sebelum pengguna dapat melihat kueri tersimpan yang Anda bagikan, Anda harus memberi mereka akses terlebih dahulu ke kueri tersimpan.

Untuk menjalankan kueri bersama, pengguna harus memiliki akses ke data yang diakses oleh kueri tersebut. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses ke set data.

Jika Anda berencana untuk membagikan kueri tersimpan, pertimbangkan untuk menyertakan komentar dalam kueri yang menjelaskan tujuannya.

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Penjelajah, luaskan project Anda dan folder Kueri, dan jika perlu, luaskan folder Kueri bersama. Temukan kueri tersimpan yang ingin Anda bagikan.

3. Klik View actions di samping kueri, lalu klik Share > Copy link.

4. Bagikan link kepada pengguna lain.

Lihat semua kueri tersimpan

Untuk melihat daftar semua kueri tersimpan di project Anda, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Penjelajah, klik Lihat tindakan di samping Kueri, lalu lakukan salah satu hal berikut:

• Untuk membuka daftar di tab saat ini, klik Tampilkan semua.
• Untuk membuka daftar di tab baru, klik Tampilkan semua di > Tab baru.
• Untuk membuka daftar di tab terpisah, klik Tampilkan semua di > Tab terpisah.

Melihat metadata kueri tersimpan

Untuk melihat metadata kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan yang ingin Anda lihat metadatanya.

3. Lihat panel Ringkasan untuk melihat informasi tentang kueri tersimpan, seperti region yang digunakan dan tanggal kueri tersimpan terakhir diubah.

Menggunakan versi kueri tersimpan

Gunakan bagian berikut untuk mempelajari cara melihat, membandingkan, dan memulihkan versi kueri tersimpan.

Melihat versi kueri tersimpan

Untuk melihat versi kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan yang ingin Anda lihat aktivitasnya.

3. Klik tab Aktivitas untuk melihat daftar versi kueri tersimpan dalam urutan menurun berdasarkan tanggal.

Membandingkan versi kueri tersimpan

Untuk membandingkan versi kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan yang ingin Anda bandingkan informasi versinya.

3. Di tab Aktivitas, klik Lihat tindakan di samping versi kueri tersimpan, lalu klik Bandingkan. Panel perbandingan akan terbuka, yang membandingkan versi kueri tersimpan yang Anda pilih dengan versi kueri tersimpan saat ini.

4. Opsional: Untuk membandingkan versi sebagai bagian dari teks, bukan di panel terpisah, klik Bandingkan, lalu klik Inline.

Memulihkan versi kueri tersimpan

Gunakan salah satu opsi berikut untuk memulihkan versi kueri tersimpan. Memulihkan dari panel perbandingan memungkinkan Anda membandingkan versi kueri tersimpan sebelumnya dengan versi saat ini sebelum memilih untuk memulihkannya atau tidak.

Panel aktivitas

1. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan yang ingin Anda pulihkan ke versi sebelumnya.
2. Pilih panel Aktivitas.
3. Klik Lihat tindakan di samping versi kueri tersimpan yang ingin Anda pulihkan, lalu klik Pulihkan.
4. Klik Konfirmasi untuk mengonfirmasi tindakan.

Panel perbandingan

1. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan yang ingin Anda pulihkan ke versi sebelumnya.
2. Pilih panel Aktivitas.
3. Klik Lihat tindakan di samping versi kueri tersimpan, lalu klik Bandingkan. Panel perbandingan akan terbuka, yang membandingkan versi kueri tersimpan yang Anda pilih dengan versi kueri tersimpan terbaru.
4. Jika Anda ingin memulihkan versi kueri tersimpan sebelumnya setelah perbandingan, klik Pulihkan.
5. Klik Konfirmasi untuk mengonfirmasi tindakan.

Mendownload kueri tersimpan

Untuk mendownload kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan untuk membukanya.

3. Klik Download.

Menghapus kueri tersimpan

Untuk menghapus kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Cari kueri tersimpan yang ingin Anda hapus.

3. Klik Lihat tindakan di samping kueri tersimpan, lalu klik Hapus.

4. Untuk mengonfirmasi penghapusan, ketik delete pada dialog.

5. Klik Hapus.

Kueri tersimpan klasik

Tidak digunakan lagi: Kueri tersimpan, yang tersedia di pratinjau BigQuery Studio, akan sepenuhnya menggantikan kueri tersimpan klasik pada Maret 2025. Untuk mengetahui informasi selengkapnya, lihat Penghentian kueri tersimpan klasik. Untuk mempelajari cara bermigrasi ke kueri tersimpan, lihat Memigrasikan kueri tersimpan klasik.

Gunakan bagian berikut untuk mempelajari cara mengelola kueri tersimpan klasik.

Catatan: Jika Anda belum mengaktifkan BigQuery Studio, kueri tersimpan klasik akan muncul di folder Kueri tersimpan (NUMBER) di panel Explorer, bukan folder (Klasik) Queries.

Membagikan kueri tersimpan klasik

Anda dapat membagikan kueri tersimpan klasik yang telah Anda berikan visibilitas project atau publik. Dengan visibilitas project, akun utama dengan izin yang diperlukan dapat melihat, memperbarui, atau menghapus kueri. Visibilitas publik memungkinkan siapa saja yang memiliki link kueri untuk melihat tetapi tidak dapat memperbarui atau menghapus kueri.

Anda membagikan kueri tersimpan klasik kepada pengguna lain dengan membuat dan membagikan link ke kueri tersimpan klasik.

Untuk menjalankan kueri bersama klasik, pengguna harus memiliki akses ke data yang diakses kueri. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses ke set data.

Jika Anda berencana untuk membagikan kueri tersimpan klasik, pertimbangkan untuk menyertakan komentar dalam kueri yang menjelaskan tujuannya.

1. Di panel Penjelajah, luaskan project Anda dan folder Kueri(Klasik), lalu temukan kueri tersimpan klasik yang ingin Anda bagikan.
2. Klik Lihat tindakan di samping kueri, lalu klik Dapatkan link.
3. Bagikan link dengan pengguna yang ingin Anda beri akses ke kueri.

Memigrasikan kueri tersimpan klasik

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Penjelajah, luaskan project Anda dan folder (Klasik) Kueri, dan jika perlu, folder Kueri project.

3. Klik nama kueri tersimpan klasik untuk membukanya.

4. Klik Simpan Kueri (Klasik) > Simpan kueri sebagai....

5. Pada dialog Simpan kueri, ketik nama dan pilih lokasi untuk kueri.

6. Klik Save.

Menghapus kueri tersimpan klasik

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Penjelajah, luaskan project Anda dan folder (Klasik) Kueri, dan jika perlu, folder Kueri project.

3. Temukan kueri tersimpan klasik yang ingin Anda hapus.

4. Klik Lihat tindakan di samping kueri, lalu klik Hapus.

5. Untuk mengonfirmasi penghapusan, ketik delete pada dialog.

6. Klik Hapus.