Tampilan CAPACITY_COMMITMENTS

Tampilan INFORMATION_SCHEMA.CAPACITY_COMMITMENTS berisi daftar semua komitmen kapasitas saat ini dalam project administrasi yang mendekati real-time. Setiap baris mewakili satu komitmen kapasitas saat ini. Komitmen kapasitas saat ini tertunda atau aktif dan belum dihapus. Untuk informasi selengkapnya tentang reservasi, lihat Komitmen.

Izin yang diperlukan

Untuk membuat kueri tampilan INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, Anda memerlukan izin Identity and Access Management (IAM) bigquery.capacityCommitments.list untuk project tersebut. Setiap peran IAM yang telah ditetapkan berikut menyertakan izin yang diperlukan:

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

Untuk informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM

Skema

Tabel virtual INFORMATION_SCHEMA.CAPACITY_COMMITMENTS memiliki skema berikut:

Nama kolom Jenis data Nilai
ddl STRING Pernyataan DDL yang digunakan untuk membuat komitmen kapasitas ini.
project_id STRING ID project administrasi.
project_number INTEGER Jumlah project administrasi.
capacity_commitment_id STRING ID yang secara unik mengidentifikasi komitmen kapasitas.
commitment_plan STRING Paket komitmen dari komitmen kapasitas.
state STRING Nyatakan komitmen kapasitas. Dapat berupa PENDING atau ACTIVE.
slot_count INTEGER Jumlah slot yang terkait dengan komitmen kapasitas.
edition STRING Edisi yang terkait dengan reservasi ini. Untuk informasi selengkapnya tentang edisi, lihat Pengantar edisi BigQuery.
is_flat_rate BOOL Apakah komitmen dikaitkan dengan model kapasitas tarif tetap lama atau edisi. Jika FALSE, komitmen saat ini dikaitkan dengan edisi. Jika TRUE, komitmen adalah model kapasitas tarif tetap lama.
renewal_plan STRING Paket komitmen baru setelah paket komitmen saat ini berakhir. Anda dapat mengubah paket perpanjangan komitmen kapan saja hingga masa berlakunya habis.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan penentu region. Jika Anda tidak menentukan penentu regional, metadata akan diambil dari semua region. Tabel berikut menjelaskan cakupan region untuk tabel virtual ini:

Nama tabel virtual Cakupan resource Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] Level project REGION
Ganti kode berikut:

  • Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.

  • REGION: nama region set data apa pun. Misalnya, `region-us`.

    • Contoh

    Contoh berikut menampilkan daftar komitmen kapasitas aktif untuk project saat ini:

    SELECT
  capacity_commitment_id,
  slot_count
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
WHERE
  state = 'ACTIVE';

    Hasilnya mirip dengan berikut ini:

    +------------------------+------------+
| capacity_commitment_id | slot_count |
+------------------------+------------+
|    my_commitment_05    |    1000    |
|    my_commitment_06    |    1000    |
|    my_commitment_07    |    1500    |
|    my_commitment_08    |    2000    |
+------------------------+------------+