Mengelola pemesanan workload

BigQuery Reservation API memungkinkan Anda membeli slot khusus (disebut komitmen), membuat kumpulan slot (disebut pemesanan), dan menetapkan project, folder, serta organisasi ke pemesanan tersebut.

Dengan pemesanan, Anda dapat menetapkan jumlah slot khusus untuk workload. Misalnya, Anda mungkin tidak ingin workload produksi bersaing dengan workload pengujian untuk slot. Anda dapat membuat pemesanan bernama prod dan menetapkan workload produksi ke pemesanan ini. Untuk mengetahui informasi selengkapnya, lihat Memahami pemesanan.

Membuat pemesanan

Bagian berikut menjelaskan cara membuat pemesanan.

Izin yang diperlukan

Untuk membuat pemesanan, Anda memerlukan izin Identity and Access Management (IAM) berikut:

• bigquery.reservations.create pada project administrasi yang mengelola kepemilikan komitmen.

Setiap peran IAM berikut yang telah ditentukan sebelumnya menyertakan izin ini:

• BigQuery Resource Editor
• BigQuery Resource Admin

Untuk mengetahui informasi lebih lanjut tentang peran IAM di BigQuery, lihat Peran dan izin yang telah ditetapkan.

Membuat pemesanan dengan slot khusus

Pilih salah satu opsi berikut:

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Capacity management.

3. Klik Buat pemesanan.

4. Di kolom Nama pemesanan, masukkan nama untuk pemesanan.

5. Dalam daftar Location, pilih lokasi. Jika Anda memilih lokasi BigQuery Omni, opsi edisi Anda akan terbatas untuk edisi Enterprise.

6. Dalam daftar Edisi, pilih edisi. Fitur edisi BigQuery seperti penskalaan otomatis hanya tersedia dalam edisi. Untuk mengetahui informasi selengkapnya, lihat Pengantar edisi BigQuery.

7. Pada daftar Pemilih ukuran pemesanan maksimum, pilih ukuran pemesanan maksimum.

8. Opsional: Di kolom Slot dasar pengukuran, masukkan jumlah slot dasar pengukuran untuk pemesanan.

   Jumlah slot penskalaan otomatis yang tersedia ditentukan dengan mengurangi nilai Slot dasar pengukuran dari Ukuran pemesanan maksimum. Misalnya, jika Anda membuat pemesanan dengan 100 slot dasar pengukuran dan ukuran pemesanan maksimum 400, pemesanan Anda memiliki 300 slot penskalaan otomatis. Untuk mengetahui informasi selengkapnya tentang slot dasar pengukuran, lihat Menggunakan pemesanan dengan slot dasar pengukuran dan penskalaan otomatis.

9. Untuk menonaktifkan berbagi slot tidak ada aktivitas dan hanya menggunakan kapasitas slot yang ditentukan, klik tombol Abaikan slot tidak ada aktivitas.

10. Untuk meluaskan bagian Advanced settings, klik panah peluas .

11. Opsional: Untuk menetapkan konkurensi tugas target, klik tombol Ganti konkurensi tugas target otomatis ke aktif dan masukkan Konkurensi Tugas Target.

12. Opsional: Untuk menetapkan kebijakan penjadwalan project default untuk pemesanan, konfigurasikan setidaknya salah satu opsi berikut:

    1. Untuk membatasi jumlah kueri simultan yang diizinkan untuk setiap project yang ditetapkan ke pemesanan, klik tombol Override project concurrency ke posisi aktif, lalu masukkan nilai di kolom Project Concurrency.
    2. Untuk membatasi penggunaan slot setiap project yang ditetapkan ke pemesanan, klik tombol Override project max slots ke posisi aktif, lalu masukkan nilai di kolom Project Max Slots.
    Catatan: Setelan ini berfungsi sebagai default untuk semua project yang ditetapkan ke pemesanan. Anda dapat mengganti batas ini untuk project tertentu menggunakan aturan penetapan.

13. Tinjau perincian slot yang ditampilkan di tabel Estimasi biaya dan ringkasan pemesanan di tabel Ringkasan kapasitas.

14. Klik Simpan.

Pemesanan baru dapat dilihat di tab Pemesanan slot.

SQL

Untuk membuat pemesanan, gunakan pernyataan DDL CREATE RESERVATION.

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri, masukkan pernyataan berikut:

   CREATE RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
   OPTIONS (
     slot_capacity = NUMBER_OF_BASELINE_SLOTS,
     edition = EDITION,
     autoscale_max_slots = NUMBER_OF_AUTOSCALING_SLOTS,
     scheduling_policy_max_slots = MAX_SLOTS_PER_PROJECT,
     scheduling_policy_concurrency = MAX_CONCURRENCY_PER_PROJECT);

   Ganti kode berikut:

   • ADMIN_PROJECT_ID: project ID dari project administrasi yang memiliki resource pemesanan
   • LOCATION: lokasi pemesanan. Jika Anda memilih lokasi BigQuery Omni, opsi edisi Anda akan terbatas untuk edisi Enterprise.

   • RESERVATION_NAME: nama pemesanan

     Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

   • NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar pengukuran yang akan dialokasikan ke pemesanan. Anda tidak dapat menetapkan opsi slot_capacity dan opsi edisi standard dalam pemesanan yang sama.
   • EDITION: edisi pemesanan. Nilai yang didukung adalah STANDARD, ENTERPRISE, dan ENTERPRISE_PLUS. Penetapan pemesanan ke edisi disertai perubahan fitur dan harga. Untuk informasi selengkapnya, lihat Pengantar edisi BigQuery.
   • NUMBER_OF_AUTOSCALING_SLOTS: jumlah slot penskalaan otomatis yang ditetapkan untuk pemesanan. Jumlah ini sama dengan nilai ukuran pemesanan maksimum dikurangi jumlah slot dasar pengukuran.
   • MAX_SLOTS_PER_PROJECT: batas default pada konsumsi slot kueri yang berjalan untuk setiap project yang ditetapkan ke pemesanan.
   • MAX_CONCURRENCY_PER_PROJECT: batas default jumlah kueri simultan yang diizinkan untuk setiap project yang ditetapkan ke pemesanan.

3. Klik Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

bq

Untuk membuat pemesanan, gunakan perintah bq mk dengan flag --reservation:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --ignore_idle_slots=false \
    --edition=EDITION \
    --autoscale_max_slots=NUMBER_OF_AUTOSCALING_SLOTS \
    --max_slots=MAXIMUM_NUMBER_OF_SLOTS
    --scaling_mode=SCALING_MODE
    RESERVATION_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan. Jika Anda memilih lokasi BigQuery Omni, opsi edisi Anda akan terbatas untuk edisi Enterprise.

• NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar pengukuran yang akan dialokasikan ke pemesanan

• RESERVATION_NAME: nama pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

• EDITION: edisi pemesanan. Nilai yang didukung adalah STANDARD, ENTERPRISE, dan ENTERPRISE_PLUS. Penetapan pemesanan ke edisi disertai perubahan fitur dan harga. Untuk mengetahui informasi selengkapnya, lihat Pengantar edisi BigQuery.

• NUMBER_OF_AUTOSCALING_SLOTS: jumlah slot penskalaan otomatis yang ditetapkan untuk pemesanan. Jumlah ini sama dengan nilai ukuran pemesanan maksimum dikurangi jumlah slot dasar pengukuran. Hal ini tidak dapat dikonfigurasi dengan flag --max_slots atau --scaling_mode.

• MAXIMUM_NUMBER_OF_SLOTS: jumlah maksimum slot yang dapat digunakan oleh pemesanan. Nilai ini harus dikonfigurasi dengan flag --scaling_mode (Pratinjau).

• SCALING_MODE: mode penskalaan pemesanan. Opsinya adalah ALL_SLOTS, IDLE_SLOTS_ONLY, atau AUTOSCALE_ONLY. Nilai ini harus dikonfigurasi dengan flag --scaling_mode (Pratinjau).

Untuk mengetahui informasi tentang flag --ignore_idle_slots, lihat Slot tidak ada aktivitas. Nilai defaultnya adalah false.

Terraform

Gunakan resource google_bigquery_reservation.

Catatan: Untuk membuat objek BigQuery menggunakan Terraform, Anda harus mengaktifkan Cloud Resource Manager API.

Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

Contoh berikut membuat pemesanan bernama my-reservation:

resource "google_bigquery_reservation" "default" {
  name              = "my-reservation"
  location          = "us-central1"
  slot_capacity     = 100
  edition           = "ENTERPRISE"
  ignore_idle_slots = false # Use idle slots from other reservations
  concurrency       = 0     # Automatically adjust query concurrency based on available resources
  autoscale {
    max_slots = 200 # Allow the reservation to scale up to 300 slots (slot_capacity + max_slots) if needed
  }
}

Untuk menerapkan konfigurasi Terraform di project Google Cloud , selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

1. Luncurkan Cloud Shell.

2. Tetapkan project Google Cloud default tempat Anda ingin menerapkan konfigurasi Terraform.

   Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

   Salin kode contoh ke dalam main.tf yang baru dibuat.

   Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.

3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
4. Simpan perubahan Anda.
5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori.

   terraform init

   Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade:

   terraform init -upgrade

Menerapkan perubahan

1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan:

   terraform plan

   Koreksi konfigurasi jika diperlukan.

2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform apply

   Tunggu hingga Terraform menampilkan pesan "Apply complete!".

3. Buka project Google Cloud Anda untuk melihat hasilnya. Di konsol Google Cloud , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Catatan: Contoh Terraform biasanya mengasumsikan bahwa API yang diperlukan diaktifkan di project Google Cloud Anda.

Python

Instal paket google-cloud-bigquery-reservation sebelum menggunakan contoh kode ini. Buat ReservationServiceClient. Jelaskan pemesanan yang ingin Anda buat dengan Pemesanan. Buat pemesanan dengan metode create_reservation.

# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Set slot_capicity to the number of slots in the
# reservation.
slot_capacity = 100

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service
from google.cloud.bigquery_reservation_v1.types import (
    reservation as reservation_types,
)

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)

parent = reservation_client.common_location_path(project_id, location)

reservation = reservation_types.Reservation(slot_capacity=slot_capacity)
reservation = reservation_client.create_reservation(
    parent=parent,
    reservation=reservation,
    reservation_id=reservation_id,
)

print(f"Created reservation: {reservation.name}")

Membuat pemesanan yang dapat diprediksi

Sebelum Anda membuat pemesanan dengan jumlah slot maksimum, keadilan berbasis pemesanan harus diaktifkan di project administrasi. Untuk project administrasi yang dibuat setelah 10 Oktober 2026, keadilan berbasis pemesanan diaktifkan secara default.

Mengaktifkan keadilan berbasis pemesanan

Untuk project administrasi yang dibuat sebelum 10 Oktober 2026 tanpa keadilan berbasis pemesanan diaktifkan, tetapkan flag enable_reservation_based_fairness ke true.

Untuk memperbarui keadilan berbasis pemesanan pada project, Anda memerlukan izin bigquery.config.update pada project yang mengelola kepemilikan pemesanan. Peran BigQuery Admin yang telah ditetapkan mencakup izin ini.

Untuk mengetahui informasi selengkapnya tentang cara mengupdate konfigurasi default project, lihat Mengelola setelan konfigurasi.

ALTER PROJECT `PROJECT_NAME` SET OPTIONS (
    `region-LOCATION.enable_reservation_based_fairness`= true);

Ganti kode berikut:

• PROJECT_NAME: project ID dari project administrasi
• LOCATION: lokasi pemesanan

Membuat pemesanan yang dapat diprediksi

Untuk membuat pemesanan yang dapat diprediksi dengan jumlah slot maksimum, pilih salah satu opsi berikut:

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel navigasi, buka bagian Workload management, lalu klik Create reservation.

3. Di kolom Nama pemesanan, masukkan nama untuk pemesanan.

4. Dalam daftar Location, pilih lokasi. Jika Anda memilih lokasi BigQuery Omni, opsi edisi Anda akan terbatas untuk edisi Enterprise.

5. Dalam daftar Edisi, pilih edisi. Untuk mengetahui informasi selengkapnya, lihat Memahami edisi BigQuery.

6. Pada daftar Pemilih ukuran pemesanan maksimum, pilih ukuran pemesanan maksimum.

7. Opsional: Di kolom Slot dasar pengukuran, masukkan jumlah slot dasar pengukuran untuk pemesanan.

   Jumlah slot penskalaan otomatis yang tersedia ditentukan dengan mengurangi nilai Slot dasar pengukuran dari Ukuran pemesanan maksimum. Misalnya, jika Anda membuat pemesanan dengan 100 slot dasar pengukuran dan ukuran pemesanan maksimum 400, pemesanan Anda memiliki 300 slot penskalaan otomatis. Untuk mengetahui informasi selengkapnya tentang slot dasar pengukuran, lihat Menggunakan pemesanan dengan slot dasar pengukuran dan penskalaan otomatis.

8. Untuk menonaktifkan berbagi slot tidak ada aktivitas dan hanya menggunakan kapasitas slot yang ditentukan, klik tombol Abaikan slot tidak ada aktivitas.

9. Untuk meluaskan bagian Advanced settings, klik panah peluas .

10. Opsional: Untuk menetapkan kebijakan penjadwalan project default untuk pemesanan, konfigurasikan opsi berikut:

    • Project Concurrency: Membatasi konkurensi tugas yang berjalan untuk project tertentu dalam pemesanan ini.
    • Slot Maksimum Project: Batasi konsumsi slot kueri yang berjalan untuk project tertentu dalam pemesanan ini.
    Catatan: Setelan ini berfungsi sebagai default untuk semua project yang ditetapkan ke pemesanan. Anda dapat mengganti batas ini untuk project tertentu menggunakan aturan penetapan.

11. Dalam daftar How to use idle slots?, pilih opsi konfigurasi.

    • Paling dapat diprediksi: Menggunakan slot dasar pengukuran terlebih dahulu, lalu slot tidak ada aktivitas, dan terakhir slot penskalaan otomatis hingga jumlah maksimum slot yang ditentukan.
    • Kurang dapat diprediksi: Hanya menggunakan slot dasar pengukuran dan slot tidak ada aktivitas, hingga jumlah slot maksimum. Tidak ada slot penskalaan otomatis yang digunakan.
    • Paling bervariasi: Semua slot tidak ada aktivitas yang tersedia digunakan untuk menskalakan di atas baseline. Kemudian, slot penskalaan otomatis digunakan, hingga selisih antara maksimum dan dasar pengukuran. Hal ini dapat menyebabkan reservasi melebihi jumlah slot maksimum yang ditentukan.

12. Perincian slot ditampilkan di tabel Estimasi biaya. Ringkasan pemesanan ditampilkan di tabel Ringkasan kapasitas.

13. Klik Simpan.

Pemesanan baru dapat dilihat di tab Pemesanan slot.

bq

Untuk membuat pemesanan yang dapat diprediksi, gunakan perintah bq mk dengan flag --reservation dan tetapkan nilai max_slots dan scaling_mode:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --ignore_idle_slots=false \
    --edition=EDITION \
    --max_slots=MAXIMUM_NUMBER_OF_SLOTS \
    --scaling_mode=SCALING_MODE
    RESERVATION_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan. Jika Anda memilih lokasi BigQuery Omni, opsi edisi Anda akan terbatas untuk edisi Enterprise.

• NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar pengukuran yang akan dialokasikan ke pemesanan

• RESERVATION_NAME: nama pemesanan

• EDITION: edisi pemesanan. Penetapan pemesanan ke edisi disertai perubahan fitur dan harga. Untuk informasi selengkapnya, lihat Pengantar edisi BigQuery.

• MAXIMUM_NUMBER_OF_SLOTS: jumlah maksimum slot yang dapat digunakan oleh pemesanan. Nilai ini harus dikonfigurasi dengan flag --scaling_mode.

• SCALING_MODE: mode penskalaan pemesanan. Opsinya adalah ALL_SLOTS, IDLE_SLOTS_ONLY, atau AUTOSCALE_ONLY. Nilai ini harus dikonfigurasi dengan flag max_slots. Nilai ini harus disesuaikan dengan flag ignore_idle_slots. Untuk mengetahui detailnya, lihat Prediktabilitas pemesanan.

Untuk mengetahui informasi tentang flag --ignore_idle_slots, lihat Slot tidak ada aktivitas. Nilai defaultnya adalah false.

SQL

Untuk membuat pemesanan yang dapat diprediksi, gunakan pernyataan DDL CREATE RESERVATION.

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri, masukkan pernyataan berikut:

   CREATE RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
   OPTIONS (
     slot_capacity = NUMBER_OF_BASELINE_SLOTS,
     edition = EDITION,
     ignore_idle_slots = IGNORE_IDLE_SLOTS,
     max_slots = MAX_NUMBER_OF_SLOTS,
     scaling_mode = SCALING_MODE,
     scheduling_policy_max_slots = MAX_SLOTS_PER_PROJECT,
     scheduling_policy_concurrency = MAX_CONCURRENCY_PER_PROJECT);

   Ganti kode berikut:

   • ADMIN_PROJECT_ID: project ID dari project administrasi yang memiliki resource pemesanan.
   • LOCATION: lokasi pemesanan. Jika Anda memilih lokasi BigQuery Omni, opsi edisi Anda akan terbatas untuk edisi Enterprise.
   • RESERVATION_NAME: nama pemesanan.Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.
   • NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar pengukuran yang akan dialokasikan ke pemesanan. Anda tidak dapat menetapkan opsi slot_capacity dan opsi edisi standard dalam pemesanan yang sama.
   • EDITION: edisi pemesanan. Penetapan pemesanan ke edisi disertai perubahan fitur dan harga. Untuk informasi selengkapnya, lihat Pengantar edisi BigQuery.
   • IGNORE_IDLE_SLOTS: apakah pemesanan menggunakan Slot tidak ada aktivitas atau tidak. Nilai defaultnya adalah false.
   • MAX_NUMBER_OF_SLOTS: jumlah maksimum slot yang dapat digunakan oleh pemesanan. Nilai ini harus dikonfigurasi dengan opsi scaling_mode.
   • SCALING_MODE: mode penskalaan pemesanan. Opsinya adalah ALL_SLOTS, IDLE_SLOTS_ONLY, atau AUTOSCALE_ONLY. Nilai ini harus dikonfigurasi dengan opsi max_slots. Nilai ini harus disesuaikan dengan opsi ignore_idle_slots. Untuk mengetahui detailnya, lihat Prediktabilitas pemesanan.
   • MAX_SLOTS_PER_PROJECT: batas default pada konsumsi slot kueri yang berjalan untuk setiap project yang ditetapkan ke pemesanan.
   • MAX_CONCURRENCY_PER_PROJECT: batas default jumlah kueri simultan yang diizinkan untuk setiap project yang ditetapkan ke pemesanan.

3. Klik Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

Terraform

Gunakan resource google_bigquery_reservation.

Catatan: Untuk membuat objek BigQuery menggunakan Terraform, Anda harus mengaktifkan Cloud Resource Manager API.

Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

Contoh berikut membuat grup pemesanan yang dapat diprediksi bernama my-reservation:

resource "google_bigquery_reservation" "default" {
  provider          = google-beta
  name              = "my-reservation"
  location          = "us-central1"
  slot_capacity     = 100
  edition           = "ENTERPRISE"
  ignore_idle_slots = true
  concurrency       = 0 # Automatically adjust query concurrency based on available resources
  max_slots         = 300
  scaling_mode      = "AUTOSCALE_ONLY"
}

Untuk menerapkan konfigurasi Terraform di project Google Cloud , selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

1. Luncurkan Cloud Shell.

2. Tetapkan project Google Cloud default tempat Anda ingin menerapkan konfigurasi Terraform.

   Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

   Salin kode contoh ke dalam main.tf yang baru dibuat.

   Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.

3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
4. Simpan perubahan Anda.
5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori.

   terraform init

   Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade:

   terraform init -upgrade

Menerapkan perubahan

1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan:

   terraform plan

   Koreksi konfigurasi jika diperlukan.

2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform apply

   Tunggu hingga Terraform menampilkan pesan "Apply complete!".

3. Buka project Google Cloud Anda untuk melihat hasilnya. Di konsol Google Cloud , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Catatan: Contoh Terraform biasanya mengasumsikan bahwa API yang diperlukan diaktifkan di project Google Cloud Anda.

Untuk mempelajari lebih lanjut pemesanan yang dapat diprediksi, lihat Pemesanan yang dapat diprediksi.

Memperbarui pemesanan

Anda dapat melakukan perubahan berikut pada pemesanan:

• Mengubah ukuran pemesanan dengan menambahkan atau menghapus slot.
• Mengonfigurasi apakah kueri dalam pemesanan ini menggunakan slot tidak ada aktivitas.
• Mengubah jumlah slot dasar pengukuran atau penskalaan otomatis yang dialokasikan untuk pemesanan.
• Menetapkan konkurensi tugas target.

Untuk mengubah edisi pemesanan, hapus pemesanan terlebih dahulu, lalu buat pemesanan dengan edisi yang diperbarui.

Izin yang diperlukan

Untuk memperbarui pemesanan, Anda memerlukan izin Identity and Access Management (IAM) berikut:

• bigquery.reservations.update pada project administrasi yang mengelola kepemilikan komitmen.

Setiap peran IAM berikut yang telah ditentukan sebelumnya menyertakan izin ini:

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

Untuk mengetahui informasi lebih lanjut tentang peran IAM di BigQuery, lihat Peran dan izin yang telah ditetapkan.

Mengaktifkan penskalaan fleksibel BigQuery

Untuk mengaktifkan penagihan per detik tanpa durasi minimum untuk pemesanan, aktifkan di tingkat project administrasi dengan mencantumkan pemesanan di opsi preflight_fluid_autoscaling_reservations. Perubahan pada konfigurasi penskalaan fleksibel BigQuery dapat memerlukan waktu beberapa menit untuk diterapkan.

Untuk pemesanan yang menggunakan disaster recovery terkelola, Anda harus mengaktifkan penskalaan fleksibel BigQuery di region utama dan sekunder untuk memastikan penagihan per detik setelah failover.

Untuk memperbarui daftar pemesanan dengan penskalaan fleksibel BigQuery, ubah daftar di opsi preflight_fluid_autoscaling_reservations. Untuk menonaktifkan fitur ini bagi semua pemesanan di suatu region, tetapkan opsi preflight_fluid_autoscaling_reservations ke NULL.

SQL

Gunakan pernyataan ALTER PROJECT SET OPTIONS:

• Untuk mengaktifkan atau memperbarui fitur ini untuk daftar reservasi:

  ALTER PROJECT `ADMIN_PROJECT_ID`
  SET OPTIONS (
    `region-LOCATION.preflight_fluid_autoscaling_reservations` = ["RESERVATION_NAME"]);
  

• Untuk menonaktifkan fitur ini bagi semua pemesanan di suatu region:

  ALTER PROJECT `ADMIN_PROJECT_ID`
  SET OPTIONS (
    `region-LOCATION.preflight_fluid_autoscaling_reservations` = NULL);
  

Ganti kode berikut:

• ADMIN_PROJECT_ID: ID project administrasi.
• LOCATION: lokasi pemesanan, misalnya us-central1.
• RESERVATION_NAME: nama pemesanan untuk mengaktifkan penskalaan fleksibel BigQuery. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

Mengubah ukuran pemesanan

Anda dapat menambahkan atau menghapus slot dari pemesanan yang ada.

Catatan: Perubahan pada nilai slot maksimum untuk pemesanan dapat memerlukan waktu hingga satu menit untuk diterapkan.

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Klik tab Slot reservations.

4. Cari pemesanan yang ingin diperbarui.

5. Perluas opsi Actions.

6. Klik Edit.

7. Pada dialog Pemilih ukuran pemesanan maksimum, masukkan ukuran pemesanan maksimum.

8. Di kolom Slot dasar pengukuran, masukkan jumlah slot dasar pengukuran.

9. Untuk meluaskan bagian Setelan lanjutan, klik panah perluas .

10. Opsional: Untuk menetapkan konkurensi tugas target, klik tombol Ganti konkurensi tugas target otomatis ke aktif dan masukkan Konkurensi Tugas Target.

11. Klik Simpan.

SQL

Untuk mengubah ukuran pemesanan, gunakan pernyataan bahasa definisi data (DDL) ALTER RESERVATION SET OPTIONS.

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri, masukkan pernyataan berikut:

   ALTER RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
   SET OPTIONS (
     slot_capacity = NUMBER_OF_BASELINE_SLOTS,
     autoscale_max_slots = NUMBER_OF_AUTOSCALING_SLOTS);

   Ganti kode berikut:

   • ADMIN_PROJECT_ID: project ID dari project administrasi yang memiliki resource pemesanan
   • LOCATION: lokasi pemesanan, misalnya europe-west9.
   • RESERVATION_NAME: nama pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.
   • NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar pengukuran yang akan dialokasikan ke pemesanan.
   • NUMBER_OF_AUTOSCALING_SLOTS: jumlah slot penskalaan otomatis yang ditetapkan untuk pemesanan. Jumlah ini sama dengan nilai ukuran pemesanan maksimum dikurangi jumlah slot dasar pengukuran.

3. Klik Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

bq

Untuk memperbarui ukuran pemesanan, gunakan perintah bq update dengan flag --reservation:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --autoscale_max_slots=NUMBER_OF_AUTOSCALING_SLOTS \
    --reservation RESERVATION_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan
• NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar pengukuran yang akan dialokasikan ke pemesanan
• RESERVATION_NAME: nama pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.
• NUMBER_OF_AUTOSCALING_SLOTS: jumlah slot penskalaan otomatis yang ditetapkan untuk pemesanan. Jumlah ini sama dengan nilai ukuran pemesanan maksimum dikurangi jumlah slot dasar pengukuran.

Python

Instal paket google-cloud-bigquery-reservation sebelum menggunakan contoh kode ini. Buat ReservationServiceClient. Deskripsikan properti yang diperbarui dengan Pemesanan dan properti FieldMask.paths. Perbarui pemesanan dengan metode update_reservation.

# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Set slot_capicity to the new number of slots in the
# reservation.
slot_capacity = 50

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service
from google.cloud.bigquery_reservation_v1.types import (
    reservation as reservation_types,
)
from google.protobuf import field_mask_pb2

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)

reservation_name = reservation_client.reservation_path(
    project_id, location, reservation_id
)
reservation = reservation_types.Reservation(
    name=reservation_name,
    slot_capacity=slot_capacity,
)
field_mask = field_mask_pb2.FieldMask(paths=["slot_capacity"])
reservation = reservation_client.update_reservation(
    reservation=reservation, update_mask=field_mask
)

print(f"Updated reservation: {reservation.name}")
print(f"\tslot_capacity: {reservation.slot_capacity}")

Mengonfigurasi kueri menggunakan atau tidak slot yang tidak ada aktivitas

Flag --ignore_idle_slots mengontrol apakah kueri yang berjalan di pemesanan dapat menggunakan slot tidak ada aktivitas dari pemesanan lain. Untuk mengetahui informasi selengkapnya, lihat Slot tidak ada aktivitas. Anda dapat memperbarui konfigurasi ini pada pemesanan yang ada.

Untuk memperbarui pemesanan, gunakan perintah bq update dengan flag --reservation. Contoh berikut menetapkan --ignore_idle_slots ke true, yang berarti pemesanan hanya akan menggunakan slot yang dialokasikan untuk pemesanan.

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --ignore_idle_slots=true \
    --reservation RESERVATION_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan
• RESERVATION_NAME: nama pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

Mencantumkan konfigurasi slot yang tidak ada aktivitas

Untuk mencantumkan setelan slot tidak ada aktivitas untuk pemesanan, lakukan langkah berikut:

SQL

Buat kueri kolom ignore_idle_slots dari tampilan INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT.

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri, masukkan pernyataan berikut:

   SELECT
     reservation_name,
     ignore_idle_slots
   FROM
     `ADMIN_PROJECT_ID.region-LOCATION`.INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT;

   Ganti kode berikut:

   • ADMIN_PROJECT_ID: project ID dari project administrasi yang memiliki resource pemesanan
   • LOCATION: lokasi pemesanan

3. Klik Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

bq

Gunakan perintah bq ls dengan flag --reservation:

bq ls --reservation \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID dari project administrasi yang memiliki resource pemesanan
• LOCATION: lokasi pemesanan

Kolom ignoreIdleSlots berisi setelan konfigurasi.

Menghapus beberapa pemesanan

Jika Anda menghapus pemesanan, tugas yang sedang berjalan dan menggunakan slot dari pemesanan tersebut akan gagal. Untuk mencegah error, izinkan tugas yang sedang berjalan selesai sebelum Anda menghapus pemesanan.

Izin yang diperlukan

Untuk menghapus pemesanan, Anda memerlukan izin Identity and Access Management (IAM) berikut:

• bigquery.reservations.delete pada project administrasi yang mengelola kepemilikan komitmen.

Setiap peran IAM berikut yang telah ditentukan sebelumnya menyertakan izin ini:

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

Untuk mengetahui informasi lebih lanjut tentang peran IAM di BigQuery, lihat Peran dan izin yang telah ditetapkan.

Perhatian: Anda dapat menghapus pemesanan dengan komitmen aktif, tetapi Anda tetap dikenai biaya untuk sisa durasi komitmen. Menghapus pemesanan atau mengalihkan project terkait ke harga on-demand tidak akan menghentikan tagihan ini. Untuk mengetahui informasi selengkapnya tentang masa berlaku komitmen, lihat masa berlaku komitmen. Untuk mendapatkan bantuan tambahan terkait pemesanan, komitmen, atau biaya, hubungi DukunganGoogle Cloud .

Hapus pemesanan

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Klik tab Slot reservations.

4. Temukan pemesanan yang ingin Anda hapus.

5. Perluas opsi Actions.

6. Klik Delete.

7. Pada dialog Hapus pemesanan, klik Hapus.

SQL

Untuk menghapus pemesanan, gunakan pernyataan DDL DROP RESERVATION.

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri, masukkan pernyataan berikut:

   DROP RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`;

   Ganti kode berikut:

   • ADMIN_PROJECT_ID: project ID dari project administrasi yang memiliki resource pemesanan
   • LOCATION: lokasi pemesanan
   • RESERVATION_NAME: ID pemesanan

3. Klik Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

bq

Untuk menghapus pemesanan, gunakan perintah bq rm dengan flag --reservation:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation RESERVATION_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID dari project administrasi yang memiliki resource pemesanan
• LOCATION: lokasi pemesanan
• RESERVATION_NAME: nama pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

Python

Instal paket google-cloud-bigquery-reservation sebelum menggunakan contoh kode ini. Buat ReservationServiceClient. Hapus pemesanan dengan metode delete_reservation.

# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)
reservation_name = reservation_client.reservation_path(
    project_id, location, reservation_id
)
reservation_client.delete_reservation(name=reservation_name)

print(f"Deleted reservation: {reservation_name}")

Mengontrol akses ke pemesanan

Anda dapat mengontrol pengguna yang memiliki akses ke pemesanan tertentu. Agar pengguna dapat mengganti pemesanan pada kuerinya, mereka harus memiliki izin reservations.use pada pemesanan tersebut.

Izin yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menentukan pemesanan tertentu untuk tugas Anda, minta administrator untuk memberi Anda peran IAM Resource Editor (roles/bigquery.resourceEditor) pada resource pemesanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin reservations.use, yang diperlukan untuk menentukan pemesanan tertentu untuk tugas Anda.

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

Mengontrol akses ke pemesanan

Untuk mengelola akses ke resource pemesanan tertentu, gunakan perintah bq set-iam-policy.

Untuk mengelola akses ke beberapa resource pemesanan, gunakan konsol Google Cloud untuk memberikan peran BigQuery Resource Editor pada project, folder, atau organisasi. Saat Anda memberikan peran, gunakan IAM Condition untuk mengizinkan akses ke resource pemesanan jika kondisi yang ditentukan terpenuhi.

Untuk mengontrol akses ke pemesanan, lakukan salah satu hal berikut:

Konsol

Di konsol Google Cloud , Anda dapat mengizinkan akses ke beberapa resource pemesanan menggunakan kondisi.

1. Di konsol Google Cloud , buka halaman IAM.

   Buka IAM

2. Pilih project, folder, atau organisasi.

3. Untuk memberikan peran bigquery.resourceEditor kepada akun utama yang memiliki peran pada resource pemesanan:

   1. Di tab Lihat menurut akun utama, buka akun utama yang sesuai atau gunakan opsi Filter untuk menemukan akun utama.

   2. Klik Edit principal.

   3. Di halaman Assign roles, klik Add roles.

   4. Di kolom Search for roles, masukkan bigquery.resourceEditor.

   5. Centang opsi BigQuery Resource Editor di hasil penelusuran, lalu klik Apply.

   6. Klik Simpan.

4. Atau, untuk memberikan peran bigquery.resourceEditor kepada akun utama yang tidak memiliki peran pada resource pemesanan:

   1. Klik Berikan Akses.

   2. Di halaman Add principals, di kolom New principals, masukkan ID akun utama — misalnya, [e-mail].

   3. Klik Add roles.

   4. Di kolom Search for roles, masukkan bigquery.resourceEditor.

   5. Centang opsi BigQuery Resource Editor di hasil penelusuran, lalu klik Apply.

   6. Di kotak BigQuery Resource Editor, klik Add condition.

   7. Di halaman Add condition:

      1. Masukkan nilai di kolom Title dan Description.

      2. Di Pembuat kondisi, tambahkan kondisi Anda. Misalnya, untuk menambahkan kondisi yang memberikan peran ke semua nama pemesanan yang diakhiri dengan /reservation1, untuk Condition type, pilih Name, untuk Operator, pilih Ends with, dan untuk Value, masukkan /reservation1.

      3. Klik Simpan.

5. Klik Simpan.

bq

Di alat command line bq, Anda dapat memberikan akses ke resource pemesanan individual.

Untuk memberikan akses ke pemesanan, gunakan perintah bq set-iam-policy:

bq set-iam-policy --reservation RESOURCE FILE_NAME

Ganti kode berikut:

• RESOURCE: ID pemesanan. Contoh, project1:US.reservation1.

• FILE_NAME: file yang berisi kebijakan dalam format JSON. Formatnya harus mengikuti struktur kebijakan IAM untuk kebijakan izin. Contoh:

  {
    "bindings": [
      {
        "members": [
          "user:[e-mail]"
        ],
        "role": "roles/bigquery.resourceEditor"
      }
    ],
    "etag": "BwUjMhCsNvY=",
    "version": 1
  }

Untuk mengetahui informasi selengkapnya tentang IAM, lihat Mengelola akses ke resource lain.

Memprioritaskan slot tidak ada aktivitas dengan grup pemesanan

Anda dapat mengontrol pemesanan mana yang mendapatkan akses prioritas ke slot tidak ada aktivitas dengan membuat grup pemesanan. Pemesanan dalam grup pemesanan akan berbagi slot tidak ada aktivitas satu sama lain sebelum tersedia untuk pemesanan lain dalam project.

Sebelum membuat grup pemesanan, Anda harus mengaktifkan keadilan berbasis pemesanan terlebih dahulu.

Izin yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk memperbarui pemesanan tertentu guna menetapkan grup pemesanan, minta administrator untuk memberi Anda peran IAM Reservation Editor (roles/bigquery.reservationEditor) pada resource pemesanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat grup pemesanan

Untuk membuat grup pemesanan:

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Centang kotak di samping pemesanan yang ingin Anda tambahkan ke grup.

4. Klik tombol Create reservation group di header tabel.

5. Di panel Create reservation group, masukkan nama grup Anda di kolom Group name.

6. Opsional: Di kolom Reservations, pilih pemesanan tambahan yang akan ditambahkan ke grup. Klik Oke.

7. Klik Create.

Grup pemesanan baru dapat dilihat di tab Pemesanan slot.

bq

Untuk membuat pemesanan, gunakan perintah bq mk dengan flag --reservation:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_group \
    RESERVATION_GROUP_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan.
• RESERVATION_GROUP_NAME: nama grup pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

Terraform

Gunakan resource google_bigquery_reservation_group.

Catatan: Untuk membuat objek BigQuery menggunakan Terraform, Anda harus mengaktifkan Cloud Resource Manager API.

Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

Contoh berikut membuat grup pemesanan bernama my-reservation-group:

resource "google_bigquery_reservation_group" "default" {
  name     = "my-reservation-group"
  location = "us-central1"
}

Untuk menerapkan konfigurasi Terraform di project Google Cloud , selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

1. Luncurkan Cloud Shell.

2. Tetapkan project Google Cloud default tempat Anda ingin menerapkan konfigurasi Terraform.

   Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

   Salin kode contoh ke dalam main.tf yang baru dibuat.

   Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.

3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
4. Simpan perubahan Anda.
5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori.

   terraform init

   Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade:

   terraform init -upgrade

Menerapkan perubahan

1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan:

   terraform plan

   Koreksi konfigurasi jika diperlukan.

2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform apply

   Tunggu hingga Terraform menampilkan pesan "Apply complete!".

3. Buka project Google Cloud Anda untuk melihat hasilnya. Di konsol Google Cloud , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Catatan: Contoh Terraform biasanya mengasumsikan bahwa API yang diperlukan diaktifkan di project Google Cloud Anda.

Menambahkan pemesanan ke grup pemesanan

Untuk menambahkan pemesanan ke grup pemesanan, perbarui properti reservation_group pemesanan:

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Perluas opsi Actions.

4. Klik Edit.

5. Di panel Edit reservation group, pilih pemesanan yang akan ditambahkan di kolom Reservations. Klik OK.

6. Klik Simpan.

Grup pemesanan diperbarui dengan pemesanan anggota terbaru.

bq

Untuk memperbarui pemesanan dan menetapkan grup pemesanan, gunakan perintah bq update dengan flag --reservation:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_group_name=RESERVATION_GROUP_NAME \
    --reservation RESERVATION_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan
• RESERVATION_GROUP_NAME: nama grup pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.
• RESERVATION_NAME: nama pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

Mencantumkan pemesanan yang memiliki grup pemesanan

Untuk mencantumkan informasi grup pemesanan untuk pemesanan Anda, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Di tab Slot reservations, Anda dapat melihat grup pemesanan dan pemesanan (tanpa grup induk) dalam tabel.

4. Klik tombol perluas di samping grup pemesanan, baris grup pemesanan akan diperluas untuk menampilkan pemesanan anggota di baris berikut.

bq

Untuk mencantumkan pemesanan dan menyertakan informasi grup pemesanan, gunakan perintah bq ls dengan flag --reservation:

bq ls \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan

Menghapus pemesanan dari grup pemesanan

Untuk menghapus pemesanan dari grup pemesanan, perbarui properti reservation_group pemesanan menjadi string kosong:

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Perluas opsi Actions.

4. Klik Edit.

5. Di panel Edit reservation group, pilih pemesanan yang akan dihapus di kolom Reservations. Klik OK.

6. Klik Simpan.

Grup pemesanan diperbarui dengan pemesanan anggota terbaru.

Jika pemesanan yang akan dihapus adalah yang terakhir dalam grup:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Perluas opsi Actions.

4. Klik Edit.

5. Klik Ungroup di panel Edit reservation group.

Grup pemesanan dihapus.

bq

Untuk menghapus pemesanan dari grup pemesanan, gunakan perintah bq update dengan flag --reservation:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_group_name="" \
    --reservation RESERVATION_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan
• NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar pengukuran yang akan dialokasikan ke pemesanan
• RESERVATION_NAME: nama pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

Menghapus grup pemesanan kosong

Grup pemesanan hanya dapat dihapus jika tidak berisi pemesanan anggota. Grup pemesanan tidak otomatis dihapus saat pemesanan anggota terakhir dihapus. Anda harus menghapus grup pemesanan secara manual setelah menghapus semua pemesanan anggota.

Konsol

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Workload management.

3. Temukan grup pemesanan yang ingin Anda hapus. Pastikan tidak ada pemesanan yang tercantum di dalamnya.

4. Luaskan opsi Actions untuk grup pemesanan.

5. Klik Edit.

6. Klik Ungroup di panel Edit reservation group.

bq

Untuk menghapus grup pemesanan kosong, gunakan perintah bq rm dengan flag --reservation_group:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_group RESERVATION_GROUP_NAME

Ganti kode berikut:

• ADMIN_PROJECT_ID: project ID
• LOCATION: lokasi pemesanan
• RESERVATION_GROUP_NAME: nama grup pemesanan. Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, dan panjang maksimumnya adalah 64 karakter.

Untuk mempelajari grup pemesanan lebih lanjut, lihat Grup pemesanan.

Memecahkan masalah tugas pengelolaan pemesanan

Anda mungkin mengalami error berikut saat membuat atau memperbarui pemesanan.

Ukuran pemesanan atau slot dasar pengukuran harus kelipatan 50

Pesan error

• Max reservation size can only be configured in multiples of 50, except when covered by excess commitments.
• Baseline slots can only be configured in multiples of 50, except when covered by excess commitments.

Penyebab

Slot selalu diskalakan otomatis ke kelipatan 50. BigQuery meningkatkan skala slot berdasarkan penggunaan aktual dan membulatkan ke atas ke penambahan 50 slot terdekat. Jika tidak ada komitmen atau jika komitmen tidak dapat menutupi peningkatan, Anda hanya dapat meningkatkan slot dasar pengukuran dan penskalaan otomatis dalam kelipatan 50.

Jika baseline slots atau max reservation size - baseline slots bukan kelipatan 50 (dan tidak tercakup dalam komitmen kapasitas berlebih), reservasi tidak dapat ditingkatkan skalanya ke ukuran reservasi maksimum, sehingga menyebabkan error ini.

Resolusi

Lakukan salah satu hal berikut:

• Membeli lebih banyak komitmen kapasitas untuk menutupi peningkatan slot.
• Pilih slot dasar pengukuran dan slot maksimum yang merupakan kelipatan 50.

Tidak dapat menggunakan slot maksimum tanpa mengaktifkan keadilan berbasis pemesanan

Pesan error

• Cannot use max slots without enabling reservation-based fairness.

Penyebab

Anda mencoba mengonfigurasi kapasitas pemesanan maksimum, misalnya, pemesanan max_slots atau yang dapat diprediksi, yang memerlukan keadilan berbasis pemesanan untuk diaktifkan pada project yang memiliki pemesanan.

Resolusi

Anda harus mengaktifkan keadilan berbasis pemesanan di project.