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.
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.
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Temukan kueri tersimpan yang ingin Anda beri akses.
Klik > Kelola Izin.
Lihat tindakan di samping kueri tersimpan, lalu klik BagikanDi panel Manage permissions, klik Add user/group.
Di kolom New principals, masukkan akun utama.
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.
Opsional: Untuk melihat daftar lengkap peran dan setelan berbagi lanjutan, klik Berbagi lanjutan.
Klik Save.
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.
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Penjelajah, luaskan project Anda dan folder Kueri, dan jika perlu, luaskan folder Kueri bersama. Temukan kueri tersimpan yang ingin Anda bagikan.
Klik > Copy link.
View actions di samping kueri, lalu klik ShareBagikan link kepada pengguna lain.
Lihat semua kueri tersimpan
Untuk melihat daftar semua kueri tersimpan di project Anda, lakukan hal berikut:
Di konsol Google Cloud, buka halaman BigQuery.
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:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan yang ingin Anda lihat metadatanya.
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:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan yang ingin Anda lihat aktivitasnya.
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:
Di konsol Google Cloud, buka halaman BigQuery.
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.
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.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
- 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.
- Pilih panel Aktivitas.
- Klik Lihat tindakan di samping versi kueri tersimpan yang ingin Anda pulihkan, lalu klik Pulihkan.
- Klik Konfirmasi untuk mengonfirmasi tindakan.
Panel perbandingan
- 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.
- Pilih panel 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 terbaru.
- Jika Anda ingin memulihkan versi kueri tersimpan sebelumnya setelah perbandingan, klik Pulihkan.
- Klik Konfirmasi untuk mengonfirmasi tindakan.
Mendownload kueri tersimpan
Untuk mendownload kueri tersimpan, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Klik nama kueri tersimpan untuk membukanya.
Klik Download.
Menghapus kueri tersimpan
Untuk menghapus kueri tersimpan, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Cari kueri tersimpan yang ingin Anda hapus.
Klik
Lihat tindakan di samping kueri tersimpan, lalu klik Hapus.Untuk mengonfirmasi penghapusan, ketik
delete
pada dialog.Klik Hapus.
Kueri tersimpan klasik
Gunakan bagian berikut untuk mempelajari cara mengelola kueri tersimpan klasik.
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.
- Di panel Penjelajah, luaskan project Anda dan folder Kueri(Klasik), lalu temukan kueri tersimpan klasik yang ingin Anda bagikan.
- Klik Lihat tindakan di samping kueri, lalu klik Dapatkan link.
- Bagikan link dengan pengguna yang ingin Anda beri akses ke kueri.
Memigrasikan kueri tersimpan klasik
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Penjelajah, luaskan project Anda dan folder (Klasik) Kueri, dan jika perlu, folder Kueri project.
Klik nama kueri tersimpan klasik untuk membukanya.
Klik Simpan Kueri (Klasik) > Simpan kueri sebagai....
Pada dialog Simpan kueri, ketik nama dan pilih lokasi untuk kueri.
Klik Save.
Menghapus kueri tersimpan klasik
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Penjelajah, luaskan project Anda dan folder (Klasik) Kueri, dan jika perlu, folder Kueri project.
Temukan kueri tersimpan klasik yang ingin Anda hapus.
Klik
Lihat tindakan di samping kueri, lalu klik Hapus.Untuk mengonfirmasi penghapusan, ketik
delete
pada dialog.Klik Hapus.