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.

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:

Izin untuk mengedit kueri tersimpan

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

Izin untuk melihat kueri tersimpan

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

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.

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

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.

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.

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