Membuat kueri tersimpan

Saat Anda menulis SQL di editor kueri, Anda dapat menyimpan kueri dan membagikan kueri Anda kepada orang lain. Kueri tersimpan adalah BigQuery Studio aset kode yang didukung oleh Dataform.

Untuk mengetahui 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 dapat memperoleh 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 Dataform Admin yang diberikan di Google Cloud project memiliki akses pemilik ke semua kueri tersimpan yang dibuat di 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)
• Code Editor (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 untuk 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 project, terlepas dari apakah mereka membuat aset ini atau aset ini dibagikan kepada mereka. Google Cloud Untuk membatasi visibilitas, Anda dapat membuat peran khusus yang mengecualikan izin dataform.repositories.list.
• Setiap secret yang dibagikan dengan agen layanan Dataform berpotensi dapat diakses oleh pengguna yang dapat mengedit aset ini. Untuk mengamankan kredensial Anda, batasi akses pembuatan dan pengeditan ke 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 Anda menggunakan region default. Google Cloud 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 untuk aset kode baru, lakukan hal berikut:

1. Buka halaman BigQuery.

   Buka BigQuery

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

   

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

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

5. Klik Save.

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 tingkat project default untuk Dataform API. Anda tidak dapat menerapkan kunci CMEK individual ke kueri tersimpan di Google Cloud konsol. 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 Google Cloud konsol, 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 Save query, 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 Save.

   Versi pertama kueri tersimpan akan 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 Comments 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 bagikan kuerinya hanya akan melihat versi kueri terbaru. Perubahan yang disimpan otomatis yang belum Anda simpan secara eksplisit tidak akan muncul di kueri bersama.

Untuk membagikan kueri tersimpan, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman BigQuery.

   Buka BigQuery

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

   Jika Anda tidak melihat panel kiri, klik Expand left pane 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:

   • Code Owner: dapat melakukan tindakan apa pun pada kueri tersimpan, termasuk menghapus atau membagikannya.
   • Code Editor: dapat mengedit kueri.
   • Code Viewer: 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 Advanced sharing.

9. Klik Save.

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

11. Untuk membuat link ke kueri tersimpan, klik View actions > Share > Copy 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 Google Cloud konsol, buka halaman BigQuery.

   Buka BigQuery

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

   

   Jika Anda tidak melihat panel kiri, klik Expand left pane 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 View actions di samping versi kueri tersimpan, lalu klik Open as new query.

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 Your changes. Perubahan yang disimpan otomatis bukanlah versi kueri baru. Perubahan yang disimpan otomatis akan muncul kembali setiap kali Anda membuka kueri, tetapi tidak dapat dilihat oleh orang lain kecuali jika Anda menyimpannya secara eksplisit sebagai versi kueri baru. Kueri yang disimpan otomatis berada dalam Pratinjau.

1. Di Google Cloud konsol, buka halaman BigQuery.

   Buka BigQuery

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

   

   Jika Anda tidak melihat panel kiri, klik Expand left pane 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 kueri baru akan dibuat.

Mengupload kueri tersimpan

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

Untuk mengupload kueri tersimpan, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman BigQuery.

   Buka BigQuery

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

   

   Jika Anda tidak melihat panel kiri, klik Expand left pane untuk membuka panel.

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

4. Dalam 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.

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 Kueri tersimpan (NUMBER) di panel Explorer, bukan folder Kueri(Klasik).

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 Google Cloud konsol, 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 Simpan kueri, masukkan nama untuk kueri Anda, lalu tetapkan Visibilitas 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 Expand left pane untuk membuka panel.

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

4. Klik View actions di samping kueri, lalu klik Copy link.

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

Memperbarui kueri tersimpan klasik

1. Di Google Cloud konsol, buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Explorer:

   

   Jika Anda tidak melihat panel kiri, klik Expand left pane 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 Simpan Kueri (Klasik) > Simpan kueri (Klasik).

Langkah berikutnya

• Pelajari cara mengelola kueri tersimpan.