Membuat kuota kueri kustom

Dokumen ini menjelaskan cara menetapkan atau mengubah kuota kueri kustom untuk mengontrol biaya. Untuk mempelajari cara analis BigQuery memperkirakan dan mengontrol biaya, lihat Memperkirakan dan mengontrol biaya.

Jika memiliki beberapa project dan pengguna BigQuery, Anda dapat mengelola biaya dengan meminta kuota kustom yang menentukan batas jumlah data yang diproses per hari. Kuota harian direset pada tengah malam Waktu Pasifik.

Kuota kustom bersifat proaktif, sehingga Anda tidak dapat menjalankan kueri sebesar 11 TB jika memiliki kuota 10 TB. Membuat kuota kustom pada data yang diproses memungkinkan Anda mengontrol biaya di level project atau level pengguna.

Untuk menetapkan kontrol biaya kustom, Anda dapat memperbarui salah satu atau kedua kuota kueri berikut:

  • QueryUsagePerDay: Kuota kustom tingkat project membatasi penggunaan gabungan dari semua pengguna dalam project tersebut.

  • QueryUsagePerUserPerDay: Kuota kustom level pengguna diterapkan secara terpisah untuk semua pengguna dan akun layanan dalam suatu project.

Untuk mengetahui informasi selengkapnya tentang kuota BigQuery yang dapat Anda tetapkan, lihat Kuota dan batas.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengubah kuota, minta administrator Anda untuk memberi Anda peran IAM Administrator Kuota (role/servicemanagement.quotaAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin serviceusage.quotas.update , yang diperlukan untuk mengubah kuota Anda.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Menetapkan atau mengubah kuota kustom

Anda dapat menetapkan kuota kustom atau mengubah kuota kustom yang ada untuk semua kuota yang ditampilkan di halaman Quotas & System Limits di konsol Google Cloud . Jika Anda meminta kuota yang lebih rendah, perubahan akan diterapkan dalam beberapa menit. Jika Anda meminta kuota yang lebih tinggi, permintaan Anda akan melalui proses persetujuan, yang dapat memakan waktu lebih lama. Untuk mengetahui informasi selengkapnya, lihat Meminta penyesuaian kuota.

Untuk menetapkan atau memperbarui kontrol biaya kustom, seperti membatasi jumlah data BigQuery yang dapat diproses setiap hari, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman IAM & Admin > Quotas & System Limits:

    Buka Quotas & System Limits

  2. Gunakan filter Layanan di kotak penelusuran Filter untuk memfilter BigQuery API.

  3. Pilih kuota yang ingin Anda sesuaikan. Misalnya, untuk membatasi jumlah data yang dapat dikueri per hari di tingkat project dan tingkat pengguna, pilih Penggunaan kueri per hari dan Penggunaan kueri per hari per pengguna. Anda mungkin perlu melihat daftar per halaman untuk menemukannya. Setelah Anda memilih kuota, toolbar akan muncul.

  4. Di toolbar, klik Edit. Dialog Perubahan kuota akan terbuka.

  5. Jika Tidak terbatas dipilih, batalkan pilihannya.

  6. Masukkan nilai kuota dalam TiB yang Anda inginkan di kolom Nilai baru.

  7. Klik Selesai.

  8. Klik Submit request.

Untuk mengetahui informasi selengkapnya tentang cara melihat dan mengelola kuota, lihat Melihat dan mengelola kuota.

Pesan error yang ditampilkan

Setelah Anda menetapkan kuota kustom, BigQuery akan menampilkan error jika Anda melebihi kuota tersebut:

  • Jika Anda melebihi kuota kustom level project, BigQuery akan menampilkan error usageQuotaExceeded:

    Custom quota exceeded: Your usage exceeded the custom quota for
QueryUsagePerDay, which is set by your administrator. For more information,
see https://cloud.google.com/bigquery/cost-controls

  • Jika pengguna melebihi kuota kustom level pengguna, BigQuery akan menampilkan error usageQuotaExceeded dengan pesan error yang berbeda:

    Custom quota exceeded: Your usage exceeded the custom quota for
QueryUsagePerUserPerDay, which is set by your administrator. For more
information, see https://cloud.google.com/bigquery/cost-controls

Anda dapat menjalankan kueri dari project lain yang memiliki akses ke set data Anda, dan dari project yang tidak memiliki kuota kustom atau belum melampauinya.

Contoh

Misalkan Anda menetapkan kuota kustom berikut untuk sebuah project dengan 10 pengguna, yang salah satunya adalah akun layanan:

  • Level project: 50 TB per hari
  • Level pengguna: 10 TB per hari

Kuota kustom level project membatasi penggunaan gabungan dari semua pengguna dalam project tersebut. Kuota kustom level pengguna diterapkan secara terpisah untuk setiap pengguna atau akun layanan dalam suatu project.

Tabel berikut menjelaskan sisa kuota saat 10 pengguna menjalankan kueri sepanjang hari.

Penggunaan Sisa kuota
Masing-masing dari 10 pengguna menjalankan kueri 4 TB Level project: Sisa 10 TB.
Level pengguna: Sisa 6 TB per pengguna, tetapi total maksimal hanya 10 TB.
Akun layanan menjalankan kueri 6 TB lainnya Level project: Sisa 4 TB.
Level pengguna: Akun layanan tidak lagi dapat menggunakan BigQuery. Sisa 6 TB per pengguna tetap ada untuk pengguna lain, tetapi total maksimal hanya 4 TB.
Satu pengguna menjalankan kueri 4 TB lainnya Level project: Sisa 0 TB.
Level pengguna: Sisa TB bervariasi, tetapi tidak ada yang dapat menggunakan BigQuery karena kuota level project telah terlampaui.

Tanpa ada sisa kuota, BigQuery berhenti bekerja untuk semua orang dalam project tersebut.

Langkah berikutnya