Tampilan CAPACITY_COMMITMENT_CHANGES

Tampilan INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES berisi daftar semua perubahan pada komitmen kapasitas dalam project administrasi. Setiap baris mewakili satu perubahan pada satu komitmen kapasitas. Untuk mengetahui informasi selengkapnya tentang reservasi, lihat Komitmen.

Izin yang diperlukan

Untuk membuat kueri tampilan INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, 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 mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Tabel virtual INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES memiliki skema berikut:

Nama kolom	Jenis data	Nilai
`change_timestamp`	`TIMESTAMP`	Waktu saat perubahan terjadi.
`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.
`action`	`STRING`	Jenis peristiwa yang terjadi pada komitmen kapasitas. Dapat berupa `CREATE`, `UPDATE`, atau `DELETE`.
`user_email`	`STRING`	Alamat email pengguna atau subjek federasi identitas tenaga kerja yang melakukan perubahan. `google` untuk perubahan yang dibuat oleh Google. `NULL` jika alamat email tidak diketahui.
`commitment_start_time`	`TIMESTAMP`	Awal periode komitmen saat ini. Hanya berlaku untuk komitmen kapasitas `ACTIVE`. Jika tidak, persyaratannya adalah `NULL`.
`commitment_end_time`	`TIMESTAMP`	Akhir periode komitmen saat ini. Hanya berlaku untuk komitmen kapasitas `ACTIVE`. Jika tidak, persyaratannya adalah `NULL`.
`failure_status`	`RECORD`	Untuk paket komitmen `FAILED`, berikan alasan kegagalan. Jika tidak, ini adalah `NULL`. `RECORD` terdiri dari `code` dan `message`.
`renewal_plan`	`STRING`	Paket komitmen kapasitas ini dikonversi setelah `commitment_end_time` diteruskan. Setelah rencana diubah, periode komitmen diperpanjang sesuai dengan rencana komitmen. Hanya berlaku untuk komitmen `ANNUAL` dan `TRIAL`. Jika tidak, ini adalah `NULL`.
`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.

Retensi data

Tampilan ini berisi komitmen kapasitas saat ini dan komitmen kapasitas terhapus yang disimpan selama maksimum 41 hari setelah penghapusan dari tampilan.

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_COMMITMENT_CHANGES[_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

Kueri berikut menampilkan pengguna yang telah memperbarui komitmen kapasitas terbaru di project saat ini pada tanggal yang ditentukan.

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

Hasilnya mirip dengan berikut ini:

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+