Pengantar kueri tersimpan

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

Kueri tersimpan

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	Detail
Afrika
	Johannesburg	africa-south1
Amerika
	Columbus	us-east5
	Dallas	us-south1	CO Rendah2
	Iowa	us-central1	CO Rendah2
	Los Angeles	us-west2
	Las Vegas	us-west4
	Montréal	northamerica-northeast1	CO Rendah2
	Virginia Virginia	us-east4
	Oregon	us-west1	CO2 Rendah
	Sao Paulo	southamerica-east1	CO Rendah2
	South Carolina	us-east1
Asia Pasifik
	Hong Kong	asia-east2
	Jakarta	asia-southeast2
	Mumbai	asia-south1
	Seoul	asia-northeast3
	Singapura	asia-southeast1
	Sydney	australia-southeast1
	Taiwan	asia-east1
	Tokyo	asia-northeast1
Eropa
	Belgia	europe-west1	CO Rendah2
	Frankfurt	europe-west3	CO Rendah2
	London	europe-west2	CO Rendah2
	Madrid	europe-southwest1	CO Rendah2
	Belanda	europe-west4	CO2 Rendah
	Turin	europe-west12
	Zürich	europe-west6	CO Rendah2
Timur Tengah
	Doha	me-central1
	Dammam	me-central2

Kuota dan batas

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

Batasan

Kueri tersimpan memiliki batasan berikut:

• Anda dapat memberikan akses publik ke kueri tersimpan hanya kepada resource utama allAuthenticatedUsers. Anda tidak dapat memberikan akses ke kueri tersimpan ke akun utama allUsers.
• Jika project Google Cloud Anda berisi lebih dari 2.500 kueri tersimpan klasik, Anda tidak dapat menggunakan migrasi batch (Pratinjau) untuk memigrasikan kueri tersimpan klasik ke 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 penggunaan 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 Kueri(Klasik).

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 memigrasikan kueri tersimpan klasik ke kueri tersimpan untuk memanfaatkan kemampuan baru, atau terus mempertahankannya sebagai kueri tersimpan klasik hingga 2025.

Fitur kueri tersimpan klasik hanya tersedia di konsol Google Cloud.

Penghentian kueri tersimpan klasik

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

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

Untuk mendukung transisi ini, peran IAM BigQuery berikut 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

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

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

Agar pengguna tanpa peran BigQuery Admin, BigQuery Job User, atau BigQuery User dapat menggunakan kueri tersimpan, berikan izin yang diperlukan di IAM.

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

Langkah selanjutnya

• Untuk mempelajari cara membuat kueri tersimpan, lihat Membuat kueri tersimpan.
• Untuk mempelajari cara mengelola kueri tersimpan, lihat Mengelola kueri tersimpan.