Menggunakan pemesanan slot

Konsol

1. Di konsol Cloud de Confiance , 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 reservasi 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 expand_more.

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

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.

SQL

Untuk membuat pemesanan, gunakan pernyataan DDL CREATE RESERVATION.

1. Di konsol Cloud de Confiance , 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);

   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, serta panjang maksimumnya adalah 64 karakter.

   • NUMBER_OF_BASELINE_SLOTS: jumlah dasar slot yang akan dialokasikan ke reservasi. Anda tidak dapat menetapkan opsi slot_capacity dan opsi edition dalam pemesanan yang sama.
   • EDITION: edisi pemesanan. 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. Nilai ini sama dengan nilai ukuran reservasi maksimum dikurangi jumlah slot dasar pengukuran.

3. Klik play_circle Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat artikel 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 yang akan dialokasikan ke reservasi

• 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, serta panjang maksimumnya adalah 64 karakter.

• EDITION: edisi pemesanan. 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. Nilai ini sama dengan nilai ukuran reservasi maksimum dikurangi jumlah slot dasar pengukuran. Ini tidak dapat dikonfigurasi dengan tanda --max_slots atau --scaling_mode.

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

• SCALING_MODE: mode penskalaan reservasi. Opsinya adalah ALL_SLOTS, IDLE_SLOTS_ONLY, atau AUTOSCALE_ONLY. Nilai ini harus dikonfigurasi dengan tanda --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.

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

Contoh berikut membuat reservasi 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 Cloud de Confiance , selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

1. Luncurkan Cloud Shell.

2. Tetapkan project Cloud de Confiance 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 Cloud de Confiance project Anda untuk melihat hasilnya. Di konsol Cloud de Confiance , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Python

# 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}")

Konsol

1. Di konsol Cloud de Confiance , buka halaman BigQuery.

   Buka BigQuery

2. Di panel navigasi, buka bagian Pengelolaan kapasitas, lalu klik Buat reservasi.

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. Penskalaan otomatis hanya tersedia dalam 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 reservasi 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 expand_more.

   1. Dalam daftar Bagaimana cara menggunakan slot tidak ada aktivitas?, pilih opsi konfigurasi.

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

11. 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 yang akan dialokasikan ke reservasi

• 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 reservasi. Nilai ini harus dikonfigurasi dengan tanda --scaling_mode.

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

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 Cloud de Confiance , 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);

   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 reservasi.Nama hanya boleh berisi karakter alfanumerik huruf kecil atau tanda hubung, harus diawali dengan huruf dan tidak boleh diakhiri dengan tanda hubung, serta panjang maksimumnya adalah 64 karakter.

   • NUMBER_OF_BASELINE_SLOTS: jumlah dasar slot yang akan dialokasikan ke reservasi. Anda tidak dapat menetapkan opsi slot_capacity dan opsi edition dalam pemesanan yang sama.
   • EDITION: edisi pemesanan. Penetapan pemesanan ke edisi disertai perubahan fitur dan harga. Untuk mengetahui informasi selengkapnya, lihat Pengantar edisi BigQuery.
   • IGNORE_IDLE_SLOTS: apakah reservasi menggunakan Slot tidak ada aktivitas atau tidak. Nilai defaultnya adalah false.
   • MAX_NUMBER_OF_SLOTS: jumlah maksimum slot yang dapat digunakan reservasi. Nilai ini harus dikonfigurasi dengan opsi scaling_mode.
   • SCALING_MODE: mode penskalaan reservasi. Opsinya adalah ALL_SLOTS, IDLE_SLOTS_ONLY, atau AUTOSCALE_ONLY. Nilai ini harus dikonfigurasi dengan opsi max_slots. Nilai ini harus selaras dengan opsi ignore_idle_slots. Untuk mengetahui detailnya, lihat Prediktabilitas reservasi.

3. Klik play_circle Run.

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

Konsol

1. Di konsol Cloud de Confiance , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Capacity management.

3. Klik tab Slot reservations.

4. Cari pemesanan yang ingin diperbarui.

5. Perluas opsi more_vert 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 expand_more.

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 Cloud de Confiance , 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, serta panjang maksimumnya adalah 64 karakter.

   • NUMBER_OF_BASELINE_SLOTS: jumlah slot dasar yang akan dialokasikan ke reservasi.
   • NUMBER_OF_AUTOSCALING_SLOTS: jumlah slot penskalaan otomatis yang ditetapkan untuk pemesanan. Nilai ini sama dengan nilai ukuran reservasi maksimum dikurangi jumlah slot dasar pengukuran.

3. Klik play_circle Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat artikel 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 yang akan dialokasikan ke reservasi
• 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, serta panjang maksimumnya adalah 64 karakter.
• NUMBER_OF_AUTOSCALING_SLOTS: jumlah slot penskalaan otomatis yang ditetapkan untuk pemesanan. Nilai ini sama dengan nilai ukuran reservasi maksimum dikurangi jumlah slot dasar pengukuran.

Python

# 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}")

SQL

Buat kueri kolom ignore_idle_slots dari tampilan INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT.

1. Di konsol Cloud de Confiance , 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 play_circle Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat artikel 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.

Konsol

1. Di konsol Cloud de Confiance , buka halaman BigQuery.

   Buka BigQuery

2. Di menu navigasi, klik Capacity management.

3. Klik tab Reservations.

4. Temukan pemesanan yang ingin Anda hapus.

5. Perluas opsi more_vert Actions.

6. Klik Delete.

7. Pada dialog Hapus pemesanan, klik Hapus.

SQL

Untuk menghapus pemesanan, gunakan pernyataan DDL DROP RESERVATION.

1. Di konsol Cloud de Confiance , 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 play_circle Run.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat artikel 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, serta panjang maksimumnya adalah 64 karakter.

Python

# 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}")

Konsol

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

1. Di konsol Cloud de Confiance , 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 reservasi:

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

   2. Klik edit Edit principal.

   3. Di halaman Tetapkan peran, klik add Tambahkan peran.

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

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

   6. Klik Simpan.

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

   1. Klik person_add Berikan Akses.

   2. Di halaman Tambahkan akun utama, di kolom Akun utama baru, masukkan ID akun utama — misalnya, //iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com.

   3. Klik add Tambahkan peran.

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

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

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

   7. Di halaman Tambahkan kondisi:

      1. Masukkan nilai di kolom Judul dan Deskripsi.

      2. Di Condition builder, tambahkan kondisi Anda. Misalnya, untuk menambahkan kondisi yang memberikan peran kepada semua nama reservasi yang berakhir dengan /reservation1, untuk Jenis kondisi, pilih Nama, untuk Operator, pilih Berakhir dengan, dan untuk Nilai, masukkan /reservation1.

      3. Klik Simpan.

5. Klik Simpan.

bq

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

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

bq set-iam-policy RESOURCE FILE_NAME

Ganti kode berikut:

• RESOURCE: nama resource reservasi. Contoh, projects/project1/locations/US/reservations/reservation1.

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

  {
    "bindings": [
      {
        "members": [
          "user:my-user@example.com"
        ],
        "role": "roles/bigquery.resourceEditor"
      }
    ],
    "etag": "BwUjMhCsNvY=",
    "version": 1
  }