Tampilan CAPACITY_COMMITMENTS

Tampilan INFORMATION_SCHEMA.CAPACITY_COMMITMENTS berisi daftar semua komitmen kapasitas saat ini dalam project administrasi. 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 akan dikaitkan dengan edisi. Jika `TRUE`, komitmennya 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.

Catatan: Anda harus menentukan lokasi untuk membuat kueri tabel virtual INFORMATION_SCHEMA dan lokasi eksekusi kueri harus cocok dengan region tabel virtual INFORMATION_SCHEMA.

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    |
+------------------------+------------+