Pengantar kueri tersimpan

Gunakan kueri tersimpan di BigQuery untuk menyimpan, mengelola, dan berkolaborasi dengan aman pada skrip SQL Anda. Saat Anda bekerja di editor kueri, perubahan Anda akan otomatis disimpan untuk mencegah hilangnya pekerjaan secara tidak sengaja.

Karena kueri tersimpan adalah aset kode BigQuery Studio yang didukung oleh Dataform, kueri tersebut menawarkan fitur kolaborasi dan kontrol versi tingkat lanjut. Anda dapat:

• Berkolaborasi dengan aman: bagikan kueri tersimpan kepada pengguna dan grup tertentu menggunakan Identity and Access Management (IAM).
• Lacak perubahan: tinjau histori versi mendetail dari hasil edit kueri Anda.
• Mengelola versi: buat cabang dari atau kembalikan ke versi kueri sebelumnya untuk menguji modifikasi dengan aman.

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 Membagikan kueri tersimpan dan Pertimbangan keamanan untuk kueri tersimpan.

Region yang didukung

Semua kueri tersimpan disimpan di region default. Mengupdate region default akan mengubah lokasi untuk kueri apa pun yang dibuat setelah waktu tersebut. 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	CO2 rendah
	Los Angeles	us-west2
	Las Vegas	us-west4
	Montréal	northamerica-northeast1	CO2 rendah
	Virginia Virginia	us-east4
	Oregon	us-west1	CO2 rendah
	Sao Paulo	southamerica-east1	CO2 rendah
	Carolina Selatan	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	CO2 Rendah
	Finlandia	europe-north1	CO Rendah2
	Frankfurt	europe-west3
	London	europe-west2	CO Rendah2
	Madrid	europe-southwest1	CO Rendah2
	Milan	europe-west8	CO Rendah2
	Belanda	europe-west4	CO2 Rendah
	Turin	europe-west12	CO2 Rendah
	Warsawa	europe-central2	CO2 rendah
	Zürich	europe-west6	CO2 rendah
Timur Tengah
	Dammam	me-central2
	Doha	me-central1
	Tel Aviv	me-west1

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 akun 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 untuk memigrasikan kueri tersimpan klasik ke kueri tersimpan.

Kueri tersimpan klasik (Tidak digunakan lagi)

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.

Untuk mengedit kueri tersimpan klasik yang ada setelah penghentian sepenuhnya, Anda harus memigrasikannya ke BigQuery Studio.

Kueri tersimpan klasik adalah metode lama untuk menyimpan dan membagikan SQL. Tidak seperti kueri tersimpan BigQuery Studio, kueri tersimpan klasik hanya mempertahankan teks kueri dan versi SQL (legacy SQL atau GoogleSQL).

Di konsol Google Cloud , kueri tersebut muncul di folder (Classic) Queries dalam panel Explorer. (Jika Anda belum mengaktifkan BigQuery Studio, kueri tersebut akan muncul di folder Saved queries (NUMBER) di panel Classic Explorer).

Terdapat tiga jenis kueri tersimpan klasik:

• Pribadi (): hanya dapat dilihat oleh pengguna yang membuatnya.

  • Catatan: Jika kueri pribadi berisi informasi sensitif, Anda harus menghapus kueri atau menghapus data sensitif sebelum migrasi.

• Level project (): dapat dilihat oleh akun utama mana pun yang memiliki izin yang diperlukan.

• Publik (): dapat dilihat oleh siapa saja yang memiliki link ke kueri.

Peran IAM untuk migrasi dan akses

Peran IAM BigQuery yang telah ditetapkan berikut mencakup izin Dataform yang diperlukan untuk membantu Anda beralih ke kueri tersimpan BigQuery Studio:

• BigQuery Admin (roles/bigquery.admin) mencakup izin roles/dataform.admin.
• BigQuery Job User (roles/bigquery.jobUser) dan BigQuery User (roles/bigquery.user) mencakup:
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list

Jika Anda tidak memiliki salah satu peran yang telah ditetapkan ini, Anda dapat meminta izin yang diperlukan. Peran khusus tidak diupdate secara otomatis dan harus diedit secara manual.

Langkah berikutnya

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