Membuat kueri tersimpan

Dengan kueri tersimpan, Anda dapat menyimpan SQL yang Anda tulis di editor kueri dan membagikannya kepada pengguna lain, sehingga tim Anda dapat menggunakan kembali dan berkolaborasi dalam kueri. Kueri tersimpan adalah aset kode BigQuery Studio yang didukung oleh Dataform.

Untuk informasi selengkapnya tentang cara menghapus kueri tersimpan dan mengelola histori kueri tersimpan, lihat Mengelola kueri tersimpan.

Izin yang diperlukan

Tetapkan izin yang sesuai untuk membuat, mengedit, atau melihat kueri tersimpan.

Semua pengguna dengan peran Dataform Admin (roles/dataform.admin) memiliki akses pemilik ke semua kueri tersimpan yang dibuat di project.

Untuk mengetahui informasi selengkapnya tentang Identity and Access Management (IAM) BigQuery, lihat Kontrol akses dengan IAM.

Izin untuk membuat kueri tersimpan

Untuk membuat dan menjalankan kueri tersimpan, Anda memerlukan izin IAM berikut:

• dataform.locations.get
• dataform.locations.list
• dataform.repositories.list
• dataform.repositories.create

Anda bisa mendapatkan izin ini dari peran IAM berikut:

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• Code Creator (roles/dataform.codeCreator)

Catatan: Pengguna yang diberi peran Code Creator dalam project dapat mencantumkan nama aset kode dalam project tersebut menggunakan Dataform API atau antarmuka command line (CLI) Dataform.

Catatan: Saat Anda membuat kueri tersimpan, BigQuery akan memberi Anda peran Dataform Admin (roles/dataform.admin) pada kueri tersimpan tersebut. Semua pengguna dengan peran Admin Dataform yang diberikan pada project Google Cloud memiliki akses pemilik ke semua kueri tersimpan yang dibuat dalam project. Untuk mengganti perilaku ini, lihat Memberikan peran tertentu saat pembuatan resource.

Izin untuk mengedit kueri tersimpan

Untuk mengedit dan menjalankan kueri tersimpan, Anda memerlukan peran IAM berikut:

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• Editor Kode (roles/dataform.codeEditor)

Izin untuk melihat kueri tersimpan

Untuk melihat dan menjalankan kueri tersimpan, Anda memerlukan peran IAM berikut:

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Read Session User (roles/bigquery.readSessionUser)
• Code Viewer (roles/dataform.codeViewer)

Pertimbangan keamanan untuk kueri tersimpan

Karena aset kode di BigQuery didukung oleh Dataform, Anda harus mempertimbangkan implikasi keamanan berikut bagi pengguna yang memiliki akses ke aset ini:

• Visibilitas untuk aset kode diatur oleh izin Dataform level project. Pengguna dengan izin dataform.repositories.list—yang disertakan dalam peran BigQuery standar seperti BigQuery Job User, BigQuery Studio User, dan BigQuery User—dapat melihat semua aset kode di panel Explorer dari project Google Cloud , terlepas dari apakah mereka membuat aset ini atau aset ini dibagikan kepada mereka. Untuk membatasi visibilitas, Anda dapat membuat peran khusus yang mengecualikan izin dataform.repositories.list.
• Setiap secret yang dibagikan kepada agen layanan Dataform berpotensi diakses oleh pengguna yang dapat mengedit aset ini. Untuk mengamankan kredensial Anda, batasi akses pembuatan dan pengeditan kepada pengguna tepercaya, dan batasi secret yang dapat diakses oleh agen layanan Dataform. Untuk mengetahui informasi selengkapnya, lihat Akses secret selama penginstalan paket.

Untuk mengetahui informasi selengkapnya, lihat Pertimbangan keamanan untuk izin Dataform.

Menetapkan region default untuk aset kode

Semua aset kode baru di project Google Cloud Anda menggunakan region default. Setelah aset dibuat, Anda tidak dapat mengubah regionnya.

Penting: Jika Anda mengubah region saat membuat aset kode, region tersebut akan menjadi default untuk semua aset kode berikutnya. Aset kode yang ada tidak terpengaruh.

Untuk menetapkan region default bagi aset kode baru, lakukan hal berikut:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Di samping nama project, klik View files panel actions > Switch code region.

4. Pilih wilayah kode yang ingin Anda gunakan sebagai default.

5. Klik Simpan.

Untuk mengetahui daftar region yang didukung, lihat Lokasi BigQuery Studio.

Mengenkripsi dengan CMEK

Anda dapat mengenkripsi kueri tersimpan yang didukung Dataform dengan kunci enkripsi yang dikelola pelanggan (CMEK) menggunakan kunci CMEK level project default untuk Dataform API. Anda tidak dapat menerapkan kunci CMEK individual ke kueri tersimpan di konsol Google Cloud . Setelan baru hanya diterapkan ke kueri tersimpan yang baru dibuat.

Untuk mengetahui informasi dan petunjuk selengkapnya tentang cara menetapkan kunci default, lihat Menggunakan CMEK untuk melindungi aset kode BigQuery Studio.

Membuat kueri tersimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Klik Kueri SQL.

3. Di editor kueri, masukkan kueri SQL yang valid. Misalnya, Anda dapat membuat kueri set data publik:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;

   Atau, Anda dapat menggunakan panel Reference untuk membuat kueri baru.

4. Klik Save > Save query atau tekan Control+S (atau Command+S di macOS).

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

6. Opsional: Untuk mengubah region yang digunakan oleh kueri tersimpan ini dan semua aset kode lainnya di masa mendatang, pilih region baru di kolom Region.

7. Klik Simpan.

   Versi pertama kueri tersimpan dibuat.

8. Opsional: Setelah menyimpan kueri, gunakan toolbar berikut untuk melihat detail kueri atau histori versi, menambahkan komentar baru, atau membalas atau mendapatkan link ke komentar yang ada:

   

   Fitur toolbar Komentar berada dalam Pratinjau. Untuk memberikan masukan atau meminta dukungan terkait fitur ini, kirim email ke [e-mail].

Membagikan kueri tersimpan

Untuk membagikan kueri tersimpan kepada pengguna, Anda harus terlebih dahulu memberi pengguna tersebut akses ke kueri tersimpan dan menambahkannya ke peran IAM yang sesuai. Kemudian, Anda membuat link ke kueri tersimpan dan membagikan link tersebut kepada pengguna.

Pengguna yang Anda ajak berbagi kueri hanya akan melihat versi kueri terbaru. Perubahan yang disimpan otomatis yang belum Anda simpan secara eksplisit tidak akan muncul dalam kueri bersama.

Untuk membagikan kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser.

   Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

3. Di panel Files, luaskan project dan subfolder Anda untuk menemukan kueri tersimpan yang ingin Anda bagikan.

4. Klik View actions di samping kueri tersimpan, lalu klik Share > Manage permissions.

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

6. Di kolom New principals, masukkan akun utama.

7. 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.
   Catatan: Akun utama juga harus memiliki peran Pengguna BigQuery (roles/bigquery.user) untuk menjalankan kueri tersimpan.

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

9. Klik Simpan.

10. Untuk kembali ke detail kueri tersimpan, klik Close.

11. Untuk membuat link ke kueri tersimpan, klik Lihat tindakan > Bagikan > Salin link.

    Link akan disalin ke papan klip Anda.

Membuka versi kueri tersimpan sebagai kueri baru

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

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

   Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

3. Di panel Files, luaskan project dan subfolder Anda untuk menemukan kueri tersimpan yang ingin Anda buka.

4. Klik kueri tersimpan, lalu klik Histori versi.

5. Klik Lihat tindakan di samping versi kueri tersimpan, lalu klik Buka sebagai kueri baru.

Memperbarui kueri tersimpan

Perubahan yang Anda buat pada teks kueri tersimpan akan otomatis disimpan dua detik setelah Anda berhenti mengetik dan muncul di Histori versi sebagai Perubahan Anda. Perubahan yang disimpan otomatis bukanlah versi baru kueri. Perubahan yang disimpan otomatis akan muncul kembali setiap kali Anda membuka kueri, tetapi tidak akan terlihat oleh orang lain kecuali jika Anda menyimpannya secara eksplisit sebagai versi baru kueri. Kueri yang disimpan otomatis berada dalam status Pratinjau.

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

   Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

3. Di panel Files, luaskan project dan subfolder Anda untuk menemukan kueri tersimpan yang ingin Anda perbarui.

4. Klik kueri tersimpan untuk membukanya.

5. Ubah kueri.

6. Untuk menyimpan kueri yang diubah, klik Save query > Save query atau tekan Control+S (atau Command+S di macOS).

   Versi baru kueri akan dibuat.

Mengupload kueri tersimpan

Anda dapat mengupload kueri SQL lokal untuk digunakan sebagai kueri tersimpan di BigQuery Studio. Kueri tersimpan yang diupload kemudian juga terlihat di halaman BigQuery pada konsol Google Cloud .

Untuk mengupload kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

   Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

3. Di panel Files, klik View actions di samping folder tempat Anda ingin mengupload kueri, lalu klik Upload > Query.

4. Di dialog Upload SQL, di kolom SQL, klik Browse, lalu pilih kueri yang ingin Anda upload.

5. Opsional: Di kolom SQL name, edit nama kueri.

6. Di kolom Region, pilih region tempat Anda ingin mengupload kueri tersimpan.

7. Klik Upload.

Kueri tersimpan Anda dapat diakses melalui panel Files atau Explorer.

Memecahkan masalah kueri tersimpan

Bagian ini menjelaskan cara menyelesaikan masalah umum terkait kueri tersimpan.

Tidak dapat menyimpan kueri

Jika Anda tidak dapat menyimpan kueri, Dataform API mungkin tidak diaktifkan untuk project. Dataform API otomatis diaktifkan untuk sebagian besar project, tetapi tidak diaktifkan untuk project yang menggunakan batasan kebijakan organisasi Restrict Resource Service Usage, seperti project terjamin.

Untuk mengatasi masalah ini, pastikan Dataform API diaktifkan:

1. Di konsol Google Cloud , buka halaman APIs & Services.
2. Telusuri Dataform API dan pastikan API tersebut diaktifkan.
3. Jika API belum diaktifkan, klik Enable.
4. Coba lagi menggunakan kueri tersimpan.

Region tidak cocok untuk kueri tersimpan

Mengubah region default untuk aset kode hanya akan memengaruhi aset yang dibuat setelah perubahan. Aset yang ada tetap berada di region aslinya.

Untuk mengatasi masalah ini, pastikan wilayah yang dipilih untuk kueri tersimpan sesuai dengan salah satu wilayah yang didukung. Jika perlu, buat kueri tersimpan baru di wilayah yang didukung atau sesuaikan region default untuk aset kode Anda.

Kueri tersimpan klasik

Tidak digunakan lagi: Kueri tersimpan, yang tersedia di BigQuery Studio, akan sepenuhnya menggantikan kueri tersimpan klasik di masa mendatang. Linimasa penghentian penggunaan sedang ditinjau. Untuk mengetahui informasi selengkapnya, lihat Penghentian penggunaan kueri tersimpan klasik. Untuk mempelajari cara bermigrasi ke kueri tersimpan, lihat Memigrasikan kueri tersimpan klasik.

Gunakan bagian berikut untuk mempelajari cara membuat dan memperbarui kueri tersimpan klasik. Untuk informasi selengkapnya tentang berbagi, memigrasikan, dan menghapus kueri tersimpan klasik, lihat Kueri tersimpan klasik.

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

Izin yang diperlukan untuk kueri tersimpan klasik

Izin IAM berikut diperlukan untuk membuat, melihat, memperbarui, dan menghapus kueri tersimpan klasik:

• Kueri tersimpan klasik pribadi:
  • Pembuatan kueri tersimpan klasik pribadi tidak memerlukan izin khusus. Anda dapat menyimpan kueri pribadi di project apa pun, tetapi hanya Anda yang dapat melihat, memperbarui, atau menghapus kueri tersebut.
• Kueri tersimpan klasik level project:
  • Membuat kueri tersimpan klasik level project memerlukan izin bigquery.savedqueries.create. Peran bigquery.admin yang telah ditetapkan mencakup izin bigquery.savedqueries.create.
  • Melihat kueri tersimpan klasik level project memerlukan izin bigquery.savedqueries.get dan bigquery.savedqueries.list. Peran yang telah ditetapkan bigquery.admin dan bigquery.user mencakup izin bigquery.savedqueries.get dan bigquery.savedqueries.list.
  • Memperbarui kueri tersimpan klasik level project memerlukan izin bigquery.savedqueries.update. Peran bigquery.admin yang telah ditetapkan mencakup izin bigquery.savedqueries.update.
  • Menghapus kueri tersimpan klasik level project memerlukan izin bigquery.savedqueries.delete. Peran bigquery.admin yang telah ditetapkan mencakup izin bigquery.savedqueries.delete.
• Kueri tersimpan klasik publik:
  • Pembuatan kueri tersimpan klasik publik tidak memerlukan izin khusus. Anda dapat menyimpan kueri tersimpan klasik publik dalam project apa pun, tetapi hanya Anda yang dapat memperbarui atau menghapus kueri tersebut. Siapa pun yang memiliki link dapat melihat kueri tersimpan klasik publik.

Untuk mengetahui informasi lebih lanjut tentang peran IAM dalam BigQuery, lihat Peran dan izin yang telah ditetapkan.

Membuat kueri tersimpan klasik

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Klik Kueri SQL.

3. Di editor kueri, masukkan kueri SQL yang valid. Misalnya, Anda dapat membuat kueri set data publik:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;

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

5. Dalam dialog Save query, masukkan nama untuk kueri Anda, lalu tetapkan Visibility ke salah satu opsi berikut:

   • Pribadi (hanya dapat diedit oleh Anda) untuk kueri tersimpan klasik pribadi.
   • Project (dapat diedit oleh akun utama dengan izin yang sesuai) untuk kueri tersimpan klasik level project.
   • Publik untuk kueri tersimpan klasik publik.

6. Klik Simpan.

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.

Untuk membagikan kueri tersimpan klasik, ikuti langkah-langkah berikut:

1. Di panel kiri, klik Explorer.

   Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

2. Di panel Explorer, luaskan project Anda, lalu klik (Classic) Queries.

3. Temukan dan klik kueri tersimpan klasik yang ingin Anda beri akses. Anda dapat menggunakan fitur penelusuran atau filter untuk menemukan kueri.

4. Klik Lihat tindakan di samping kueri, lalu klik Salin link.

5. Bagikan link dengan pengguna yang ingin Anda beri akses ke kueri.

Memperbarui kueri tersimpan klasik

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Explorer:

   

   Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

3. Di panel Explorer, luaskan project Anda dan folder (Classic) Queries, dan jika perlu, folder Project queries.

4. Klik nama kueri tersimpan klasik untuk membukanya.

5. Ubah kueri.

6. Untuk menyimpan kueri yang diubah, klik Save Query (Classic) > Save query (Classic).

Memecahkan masalah kueri tersimpan klasik

Bagian ini menjelaskan cara menyelesaikan masalah umum terkait kueri tersimpan klasik.

Tidak dapat mengakses kueri tersimpan dari pengguna yang dinonaktifkan

Tidak seperti kueri tersimpan BigQuery Studio, yang dapat diakses oleh administrator project, kueri tersimpan klasik pribadi tidak dapat diakses jika pengguna yang membuatnya telah keluar dari organisasi dan Akun Google-nya telah dinonaktifkan atau ditangguhkan. Kueri akan hilang dari konsol Google Cloud untuk semua pengguna, kecuali pemilik aslinya.

Untuk memulihkan kueri ini, administrator Google Workspace atau Cloud Identity harus melakukan langkah-langkah berikut:

1. Aktifkan kembali akun pengguna yang dinonaktifkan untuk sementara.
2. Reset sandi pengguna.
3. Login ke konsol Google Cloud sebagai pengguna yang diaktifkan kembali.
4. Di editor kueri, buka setiap kueri tersimpan.
5. Klik Save atau Save query as.
6. Ubah Visibility dari Personal menjadi Project.
7. Klik Simpan. Tindakan ini membuat kueri dapat dilihat oleh pengguna lain dalam project yang sama yang memiliki izin yang diperlukan.
8. Setelah semua kueri dimigrasikan, tangguhkan kembali akun pengguna.

Untuk mencegah masalah ini, simpan kueri yang penting bagi bisnis atau yang dibagikan ke tim dengan visibilitas Project.

Langkah berikutnya

• Pelajari cara mengelola kueri tersimpan.