Membuat kueri tersimpan

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

Kueri tersimpan

Gunakan bagian berikut untuk mempelajari cara membuat kueri tersimpan. 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 Kueri tersimpan.

Mengaktifkan BigQuery Studio

Ikuti petunjuk dalam artikel Mengaktifkan BigQuery Studio untuk pengelolaan aset guna menyimpan, membagikan, dan mengelola versi aset kode seperti kueri tersimpan.

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

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

  Catatan: Pengguna yang memiliki izin dataform.repositories.create dapat mengeksekusi kode menggunakan akun layanan Dataform default dan semua izin yang diberikan ke akun layanan tersebut. Untuk mengetahui informasi selengkapnya, lihat Pertimbangan keamanan untuk izin Formulir data.

Anda bisa mendapatkan izin ini dari peran IAM berikut:

• BigQuery Job User (roles/bigquery.jobUser)
• Pengguna Sesi Baca BigQuery (roles/bigquery.readSessionUser)

• Pembuat Kode (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. Non-administrator yang menggunakan BigQuery Studio hanya dapat melihat aset kode yang mereka buat atau yang dibagikan kepada mereka.

Izin untuk mengedit kueri tersimpan

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

• BigQuery Job User (roles/bigquery.jobUser)
• Pengguna Sesi Baca BigQuery (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)
• Pengguna Sesi Baca BigQuery (roles/bigquery.readSessionUser)
• Code Viewer (roles/dataform.codeViewer)

Menetapkan region default untuk aset kode

Jika ini adalah pertama kalinya Anda membuat aset kode, tetapkan region default untuk aset kode. Anda tidak dapat mengubah region untuk aset kode setelah dibuat.

Catatan: Jika Anda membuat kueri tersimpan dan memilih region default yang berbeda dengan yang telah digunakan untuk aset kode, misalnya memilih us-west1 saat Anda menggunakan us-central1, maka kueri tersebut dan semua aset kode yang Anda buat setelahnya akan menggunakan region baru tersebut secara default. Aset kode yang ada akan terus menggunakan region yang ditetapkan saat aset tersebut dibuat.

Membuat kueri tersimpan

Untuk membuat kueri tersimpan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Klik Tulis kueri baru.

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 > Simpan kueri.

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

7. Klik Simpan.

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.

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 Explorer, luaskan project Anda dan folder Queries, dan jika perlu, folder Kueri bersama. Pilih kueri tersimpan.

3. Pilih panel Aktivitas.

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

Memperbarui kueri tersimpan

Jika memperbarui kueri tersimpan, Anda dapat menyimpan perubahan dalam versi baru kueri.

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. Ubah kueri.

4. Untuk menyimpan kueri yang diubah, klik Simpan Kueri > Simpan kueri.

   Versi baru kueri telah dibuat, yang dapat Anda lihat di panel Aktivitas.

Upload kueri tersimpan

Anda dapat mengupload kueri SQL lokal untuk menggunakannya sebagai kueri tersimpan di BigQuery Studio. Kueri tersimpan yang diupload 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 Explorer, luaskan project Anda, lalu lakukan salah satu hal berikut:

   • Di samping Kueri, klik Lihat tindakan > Upload kueri SQL.
   • Di samping nama project Google Cloud, klik View actions > Upload to project > SQL query.

3. Pada dialog Upload SQL, di kolom SQL, klik Browse, lalu pilih kueri yang ingin diupload.

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

5. Di kolom Wilayah, pilih wilayah tempat Anda ingin mengupload kueri tersimpan.

6. Klik Upload.

Kueri tersimpan akan muncul di panel Penjelajah.

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 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 (Klasik) 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 klasik yang disimpan secara publik.

Catatan: Pengguna yang diberi izin dataform.repository.list di level project dapat melihat semua kueri tersimpan yang dibuat dalam project.

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 Tulis kueri baru.

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 bersama klausa 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 Save.

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.

Memperbarui 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. Ubah kueri.

5. Untuk menyimpan kueri yang diubah, klik Simpan Kueri (Klasik) > Simpan kueri (Klasik).

Langkah selanjutnya

• Pelajari cara mengelola kueri tersimpan.