Pengantar kueri tersimpan

Dokumen ini berisi pengantar kueri tersimpan dan kueri tersimpan klasik di BigQuery.

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.

Dokumen ini berisi pengantar kueri tersimpan di BigQuery. Anda dapat menggunakan kueri tersimpan untuk membuat dan mengelola skrip SQL. Kueri tersimpan meningkatkan kolaborasi dan pengelolaan kueri dengan opsi berikut:

• Bagikan kueri kepada pengguna dan grup tertentu dengan menggunakan Identity and Access Management (IAM).
• Tinjau histori versi kueri.
• Kembalikan ke atau cabang dari versi kueri sebelumnya.

Kueri tersimpan menyimpan teks kueri dan setelan kueri.

Kueri tersimpan adalah aset kode BigQuery Studio yang didukung oleh Dataform. Notebook juga merupakan aset kode. Semua aset kode disimpan di region default. Mengupdate region default akan mengubah region untuk semua aset kode yang dibuat setelah waktu tersebut.

Kemampuan kueri tersimpan hanya tersedia di konsol Google Cloud.

Keamanan kueri tersimpan

Anda akan mengontrol akses ke kueri tersimpan dengan menggunakan peran Identity and Access Management (IAM). Untuk mengetahui informasi selengkapnya, lihat Memberikan akses ke kueri tersimpan.

Region yang didukung

BigQuery Studio memungkinkan Anda menyimpan, membagikan, dan mengelola kueri tersimpan. Tabel berikut mencantumkan region tempat BigQuery Studio tersedia:

	Deskripsi region	Nama region	Model detail
Amerika
	Iowa	us-central1	CO2 Rendah
	Oregon	us-west1	CO2 Rendah
	Sao Paulo	southamerica-east1	CO Rendah2
	South Carolina	us-east1
Asia Pasifik
	Mumbai	asia-south1
	Singapura	asia-southeast1
	Taiwan	asia-east1
	Tokyo	asia-northeast1
Eropa
	Belgia	europe-west1	CO Rendah2
	Frankfurt	europe-west3	CO Rendah2
	London	europe-west2	CO Rendah2
	Belanda	europe-west4
	Zürich	europe-west6	CO2 Rendah

Kuota dan batas

Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas kueri tersimpan.

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.

Kueri tersimpan klasik adalah cara lebih awal untuk menyimpan dan berbagi kueri SQL. Kueri tersimpan klasik berisi teks kueri, dan satu-satunya setelan kueri yang dipertahankan oleh kueri tersimpan klasik adalah versi SQL. Setelan ini mengatur apakah kueri menggunakan legacy SQL atau GoogleSQL. Untuk membuat kueri data, pengguna harus memiliki akses ke data yang diakses oleh kueri tersimpan. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses ke kueri tersimpan.

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

Terdapat 3 jenis kueri tersimpan klasik:

• Pribadi. Kueri tersimpan klasik pribadi hanya dapat dilihat oleh pengguna yang membuatnya. Hal tersebut diidentifikasi dengan ikon .
• Level project. Kueri tersimpan level project dapat dilihat oleh akun utama yang memiliki izin yang diperlukan. Hal tersebut diidentifikasi dengan ikon .
• Publik. Kueri tersimpan klasik publik dapat dilihat oleh siapa saja yang memiliki link ke kueri. Hal tersebut diidentifikasi dengan ikon .

Anda dapat migrate kueri tersimpan klasik ke kueri tersimpan untuk memanfaatkan kemampuan baru, atau terus mempertahankannya sebagai kueri tersimpan klasik hingga tahun 2025.

Fitur kueri tersimpan klasik hanya tersedia di konsol Google Cloud.

Penghentian kueri tersimpan klasik

Pada Maret 2025, fitur kueri tersimpan di BigQuery Studio akan menggantikan kueri tersimpan klasik. Untuk mengedit kueri tersimpan klasik yang sudah ada setelah tahun 2024, Anda harus memigrasikan kueri klasik ke kueri tersimpan.

Jika pengguna, termasuk Anda, memiliki kueri pribadi dengan informasi yang tidak boleh tersedia bagi orang lain yang memiliki akses ke data di project, pemilik kueri harus menghapus kueri atau informasi tersebut paling lambat Maret 2025.

Untuk mendukung transisi ini, peran IAM BigQuery berikut akan diperbarui pada Februari 2024:

• BigQuery Admin (roles/bigquery.admin) akan mendapatkan izin Dataform Admin (roles/dataform.admin).

• BigQuery Job User (roles/bigquery.jobUser) akan mendapatkan izin berikut:

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

• BigQuery User (roles/bigquery.user) akan mendapatkan izin berikut:

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

Untuk mengizinkan pengguna yang tidak memiliki peran Admin BigQuery, BigQuery Job User, atau BigQuery User menggunakan kueri tersimpan, beri mereka izin yang diperlukan di IAM.

Peran khusus tidak akan diperbarui secara otomatis. Untuk memperbarui peran khusus dengan izin yang diperlukan, baca artikel Mengedit peran khusus yang sudah ada.

Langkah selanjutnya

• Pelajari cara membuat kueri tersimpan.
• Pelajari cara mengelola kueri tersimpan.