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.

Sebelum memulai

Untuk mengelola kueri tersimpan BigQuery Studio dan memigrasikan kueri tersimpan klasik ke kueri tersimpan BigQuery Studio, lakukan tindakan berikut:

  1. Aktifkan BigQuery Studio di project Anda.

  2. Opsional: Untuk menetapkan izin IAM pada kueri tersimpan klasik project atau publik yang dimigrasikan selama migrasi (Pratinjau), create atau pilih kueri tersimpan BigQuery Studio dan berikan izin Identity and Access Management (IAM) yang dipilih ke kueri tersimpan tersebut.

    1. Selama migrasi kueri tersimpan klasik publik atau project ke kueri tersimpan BigQuery Studio, pilih kueri tersimpan BigQuery Studio untuk menyalin izin yang diberikan ke kueri tersimpan yang dimigrasikan.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna mengelola kueri tersimpan, minta administrator untuk memberi Anda peran IAM berikut pada project yang kuerinya ingin Anda kelola:

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

Peran bawaan ini berisi izin yang diperlukan untuk mengelola kueri tersimpan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola kueri tersimpan:

  • Untuk mengelola kueri tersimpan BigQuery Studio di konsol Google Cloud: bigquery.config.get, bigquery.jobs.create, dataform.locations., resourcemanager.projects.get, resourcemanager.projects.list, bigquery.readsessions., dataform.repositories., dataform.workspaces.
  • Untuk mengelola kueri tersimpan BigQuery Studio menggunakan BigQuery API: dataform.locations., dataform.repositories., dataform.workspaces.*, resourcemanager.projects.get, resourcemanager.projects.list
  • Untuk memigrasikan kueri tersimpan klasik project ke kueri tersimpan BigQuery Studio: bigquery.savedqueries.get, bigquery.savedqueries.list, bigquery.savedqueries.update, resourcemanager.projects.setIamPolicy
  • Untuk mengizinkan pengguna terautentikasi melihat kueri akses publik: dataform.locations.*, dataform.repositories.computeAccessTokenStatus, dataform.repositories.fetchHistory, dataform.repositories.fetchRemoteBranches, dataform.repositories.get, dataform.repositories.getIamPolicy, dataform.repositories.list, dataform.repositories.queryDirectoryContents, dataform.repositories.readFile, dataform.workspaces.fetchFileDiff, dataform.workspaces.fetchFileGitStatuses, dataform.workspaces.fetchGitAheadBehind. dataform.workspaces.get, dataform.workspaces.getIamPolicy, dataform.workspaces.list, dataform.workspaces.queryDirectoryContents, dataform.workspaces.readFile, dataform.workspaces.searchFiles, resourcemanager.projects.get, resourcemanager.projects.list

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

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 Kueri, 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. Di daftar Role, 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.
  7. Opsional: Untuk melihat daftar lengkap peran dan setelan berbagi lanjutan, klik Berbagi lanjutan.

  8. Klik Simpan.

  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 Explorer, luaskan project dan folder Kueri, dan jika perlu, luaskan folder Kueri bersama. Temukan kueri tersimpan yang ingin Anda bagikan.

  3. Klik Lihat tindakan di samping kueri, lalu klik Bagikan > Salin link.

  4. Bagikan link kepada pengguna lain.

Memberikan akses publik ke kueri tersimpan

Anda dapat memberikan akses publik ke kueri tersimpan BigQuery Studio dengan memberikan peran Code Viewer (roles/dataform.codeViewer) pada kueri tersimpan kepada akun utama allAuthenticatedUsers.

Saat Anda menetapkan peran IAM ke akun utama allAuthenticatedUsers, akun layanan dan semua pengguna di internet yang telah diautentikasi dengan Akun Google akan diberi peran tersebut. Hal ini mencakup akun yang tidak terhubung ke akun Google Workspace atau domain Cloud Identity, seperti akun Gmail pribadi. Pengguna yang tidak diautentikasi, seperti pengunjung anonim, tidak akan disertakan. Untuk mengetahui informasi selengkapnya, lihat Semua pengguna yang diautentikasi.

Misalnya, saat Anda memberikan peran Code Viewer ke allAuthenticatedUsers pada kueri tersimpan sales, semua akun layanan dan pengguna di internet yang telah diautentikasi dengan Akun Google memiliki akses hanya baca ke kueri tersimpan sales.

Untuk memberikan akses publik ke kueri tersimpan BigQuery Studio, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

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

  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 allAuthenticatedUsers.

  6. Di daftar Role, pilih peran Code Viewer.

  7. Klik Simpan.

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

Mencegah akses publik ke kueri tersimpan

Untuk memastikan tidak ada akses publik yang diberikan ke kueri tersimpan BigQuery Studio, batasi akun utama allAuthenticatedUsers di project Anda.

Untuk membatasi allAuthenticatedUsers dalam project, Anda dapat menetapkan kebijakan iam.allowedPolicyMemberDomains, dan menghapus allAuthenticatedUsers dari daftar allowed_values.

Jika Anda membatasi allAuthenticatedUsers dalam kebijakan iam.allowedPolicyMemberDomains, akun utama allAuthenticatedUsers tidak dapat digunakan dalam kebijakan IAM apa pun di project Anda, sehingga mencegah pemberian akses publik ke semua resource, termasuk kueri tersimpan BigQuery Studio.

Untuk informasi selengkapnya tentang kebijakan iam.allowedPolicyMemberDomains dan petunjuk untuk menetapkannya, lihat Membatasi identitas berdasarkan domain.

Melihat 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 Explorer, klik Lihat tindakan di samping Kueri, lalu lakukan salah satu tindakan 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, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Explorer, luaskan project Anda dan folder Kueri, 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, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Explorer, luaskan project Anda dan folder Kueri, 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, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Explorer, luaskan project Anda dan folder Kueri, 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: Versi kueri tersimpan saat ini juga menampilkan perubahan yang belum disimpan. Untuk menyimpan perubahan ini, klik Ganti.

  5. 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 Kueri, 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 tersebut.

Panel perbandingan

  1. Di panel Explorer, luaskan project Anda dan folder Kueri, 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 tersebut.

Mendownload kueri tersimpan

Untuk mendownload kueri tersimpan, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

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

  3. Klik Download.

Menghapus kueri tersimpan

Untuk menghapus kueri tersimpan, lakukan langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Explorer, luaskan project Anda dan folder Kueri, 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

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.

  1. Di panel Explorer, 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.

Menyimpan kueri klasik sebagai kueri tersimpan

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, luaskan project Anda dan folder Kueri(Klasik), 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 Simpan.

Memigrasikan kueri tersimpan klasik

Untuk meminta dukungan atau memberikan masukan terkait fitur ini, kirim email ke bigquery-studio-support-alias@google.com.

Untuk memigrasikan kueri tersimpan klasik secara massal, Anda harus diberi peran yang diperlukan. Izin yang diberikan oleh peran ini menentukan jenis kueri tersimpan klasik yang dapat Anda migrasikan.

Anda dapat memigrasikan kueri tersimpan klasik berikut secara massal:

Kueri tersimpan klasik pribadi
Kueri tersimpan klasik pribadi hanya dapat dilihat oleh pengguna yang membuatnya. Hal tersebut diidentifikasi dengan ikon . Kueri tersimpan klasik pribadi hanya dapat dimigrasikan oleh pemiliknya. Administrator dan pengguna yang diberi akses ke kueri tersimpan BigQuery Studio yang dimigrasikan mungkin dapat mengakses, mengubah, atau menghapus kueri tersimpan pribadi.
Kueri tersimpan klasik publik

Kueri tersimpan klasik publik dapat dilihat oleh siapa saja yang memiliki link ke kueri. Hal tersebut diidentifikasi dengan ikon . Kueri tersimpan klasik publik hanya dapat dimigrasikan oleh pemiliknya.

Izin IAM pada kueri tersimpan klasik publik tidak dipetakan ke izin pada kueri tersimpan BigQuery Studio. Artinya, kueri tersimpan BigQuery Studio yang dimigrasikan dari kueri tersimpan klasik publik tidak tersedia secara publik secara default. Anda perlu menetapkan izin IAM untuk kueri tersimpan BigQuery Studio yang dimigrasikan, baik selama maupun setelah migrasi.

Untuk menetapkan izin IAM untuk kueri tersimpan BigQuery Studio yang dimigrasikan selama migrasi, Anda dapat memilih kueri tersimpan BigQuery Studio yang ada yang memiliki izin yang ingin Anda terapkan ke kueri tersimpan yang dimigrasikan. BigQuery akan menyalin izin yang diberikan pada kueri tersimpan BigQuery Studio yang dipilih, dan menerapkannya ke kueri tersimpan yang dimigrasikan. Anda juga dapat menambahkan pengguna atau grup secara manual yang ingin Anda beri akses ke kueri tersimpan yang dimigrasikan.

Jika Anda tidak menetapkan izin IAM selama migrasi, hanya Anda yang akan memiliki akses ke kueri tersimpan BigQuery Studio yang dimigrasikan.

Kueri tersimpan klasik project

Kueri tersimpan level project dapat dilihat oleh akun utama yang memiliki izin yang diperlukan. Hal tersebut diidentifikasi dengan ikon . Anda dapat memigrasikan semua kueri tersimpan klasik project secara massal di project Anda.

Izin IAM pada kueri tersimpan klasik project tidak langsung dikaitkan dengan izin pada kueri tersimpan BigQuery Studio. Anda perlu menetapkan izin IAM untuk kueri tersimpan BigQuery Studio yang dimigrasikan, baik selama maupun setelah migrasi.

Untuk menetapkan izin IAM untuk kueri tersimpan BigQuery Studio yang dimigrasikan selama migrasi, Anda dapat memilih kueri tersimpan BigQuery Studio yang ada yang memiliki izin yang ingin Anda terapkan ke kueri tersimpan yang dimigrasikan. BigQuery akan menyalin izin yang diberikan pada kueri tersimpan BigQuery Studio yang dipilih, dan menerapkannya ke kueri tersimpan yang dimigrasikan. Anda juga dapat menambahkan pengguna atau grup secara manual yang ingin Anda beri akses ke kueri tersimpan yang dimigrasikan.

Jika Anda tidak menetapkan izin IAM selama migrasi, hanya Anda yang akan memiliki akses ke kueri tersimpan BigQuery Studio yang dimigrasikan.

Selama migrasi batch kueri tersimpan klasik, BigQuery melakukan hal berikut:

  • Menyimpan semua kueri tersimpan klasik yang dimigrasikan sebagai kueri tersimpan BigQuery Studio, yang disimpan di region yang dipilih.
  • Mengonversi semua kueri tersimpan klasik yang dimigrasikan menjadi kueri tersimpan klasik hanya baca, yang tersedia hingga tahun 2025.

Setelah migrasi, Anda dapat mengakses kueri tersimpan klasik pribadi, publik, dan project sebagai kueri tersimpan BigQuery Studio dan sebagai kueri tersimpan klasik hanya baca. Kueri tersimpan klasik yang hanya dapat dibaca tersedia hingga tahun 2025.

Risiko migrasi

Setelah migrasi batch, Anda tidak akan dapat mengubah kueri tersimpan klasik yang dimigrasikan. Kueri tersimpan klasik pribadi, publik, dan project Anda yang dimigrasikan menjadi hanya baca. Kueri tersimpan klasik pribadi, publik, dan project hanya baca tersedia hingga 2025.

BigQuery akan menambahkan kueri tersimpan BigQuery Studio yang dimigrasikan ke project Google Cloud Anda menggunakan Dataform API. Untuk mengembalikan perubahan ini, Anda harus melakukan pembersihan secara manual.

Memigrasikan kueri tersimpan klasik secara massal

Untuk memigrasikan kueri tersimpan klasik dalam project Anda ke kueri tersimpan BigQuery Studio secara massal, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Explorer, luaskan project Anda, lalu klik Lihat tindakan di samping Kueri(Klasik), lalu klik Migrasikan kueri tersimpan klasik.

  3. Di panel Migrasi kueri tersimpan klasik, di bagian Periksa kesiapan migrasi, klik Berikutnya untuk mengonfirmasi bahwa Anda memiliki peran yang diperlukan.

    Izin IAM Anda menentukan jenis kueri tersimpan klasik yang dapat Anda migrasikan dan bagian panel Migrasi kueri tersimpan klasik yang dapat Anda lihat.

  4. Di bagian Region, pada drop-down Region, pilih region tempat BigQuery akan menyimpan kueri tersimpan yang dimigrasikan.

    Sebaiknya pilih region default untuk aset kode BigQuery Studio. Untuk mengetahui informasi selengkapnya, lihat Menetapkan region default untuk aset kode.

  5. Untuk memigrasikan semua kueri tersimpan klasik pribadi Anda, di bagian Migrasikan kueri pribadi, centang kotak Migrasikan semua kueri pribadi, lalu klik Berikutnya.

  6. Untuk memigrasikan semua kueri tersimpan klasik publik dalam project Anda, di bagian Migrate public queries, lakukan hal berikut:

    1. Centang kotak Migrasikan semua kueri publik.
    2. Di menu dropdown SQL, pilih kueri tersimpan BigQuery Studio yang memiliki kebijakan IAM yang ingin Anda terapkan ke kueri tersimpan yang dimigrasikan.
    3. Opsional: Untuk menambahkan pengguna atau grup yang ingin Anda ajak berbagi kueri tersimpan yang dimigrasikan, klik Tambahkan Pengguna/Grup dan Berikan akses ke kueri tersimpan.

      Untuk membagikan kueri tersimpan yang dimigrasikan secara publik, tetapkan allAuthenticatedUsers sebagai akun utama, dan berikan peran Code Viewer. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses publik.

    4. Klik Berikutnya.

  7. Untuk memigrasikan kueri tersimpan klasik level project, di bagian Migrate project queries, lakukan hal berikut:

    1. Centang kotak Migrate all project queries.
    2. Di menu dropdown SQL, pilih kueri tersimpan BigQuery Studio yang memiliki kebijakan IAM yang ingin Anda terapkan ke kueri tersimpan yang dimigrasikan.
    3. Opsional: Untuk menambahkan pengguna atau grup yang ingin Anda ajak berbagi kueri tersimpan yang dimigrasikan, klik Tambahkan Pengguna/Grup dan Berikan akses ke kueri tersimpan.
    4. Klik Berikutnya.
  8. Untuk mengonfirmasi bahwa Anda memahami risiko migrasi dan ingin memigrasikan kueri tersimpan klasik secara massal, di bagian Konfirmasi, di kolom Konfirmasi, masukkan confirm, lalu klik Berikutnya.

  9. Klik Kirim.

Migrasi dapat memerlukan waktu lebih dari 15 menit, bergantung pada jumlah kueri yang dimigrasikan.

Menghapus kueri tersimpan klasik

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Explorer, luaskan project Anda dan folder Kueri(Klasik), 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.

Langkah selanjutnya