Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Tampilan CAPACITY_COMMITMENT_CHANGES
Tampilan INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES berisi daftar semua perubahan pada komitmen kapasitas dalam project administrasi yang mendekati real-time. Setiap baris mewakili satu perubahan pada satu komitmen kapasitas.
Untuk mengetahui informasi selengkapnya, lihat Komitmen slot.
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:
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 dikaitkan dengan edisi. Jika TRUE, komitmen 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:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eINFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES\u003c/code\u003e view provides a real-time record of all changes made to capacity commitments within an administration project, with each row detailing a single change.\u003c/p\u003e\n"],["\u003cp\u003eQuerying this view requires the \u003ccode\u003ebigquery.capacityCommitments.list\u003c/code\u003e IAM permission, which is included in roles such as \u003ccode\u003eroles/bigquery.resourceAdmin\u003c/code\u003e, \u003ccode\u003eroles/bigquery.resourceEditor\u003c/code\u003e, \u003ccode\u003eroles/bigquery.resourceViewer\u003c/code\u003e, \u003ccode\u003eroles/bigquery.user\u003c/code\u003e, and \u003ccode\u003eroles/bigquery.admin\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach entry in the view includes details like the \u003ccode\u003echange_timestamp\u003c/code\u003e, \u003ccode\u003eproject_id\u003c/code\u003e, \u003ccode\u003ecapacity_commitment_id\u003c/code\u003e, \u003ccode\u003ecommitment_plan\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, \u003ccode\u003eslot_count\u003c/code\u003e, \u003ccode\u003eaction\u003c/code\u003e, and the \u003ccode\u003euser_email\u003c/code\u003e that initiated the change.\u003c/p\u003e\n"],["\u003cp\u003eThe data in this view is retained for a maximum of 41 days after a capacity commitment is deleted, after which it is permanently removed from the view.\u003c/p\u003e\n"],["\u003cp\u003eQueries against this view must include a region qualifier, and the location of the query execution must match the region of the \u003ccode\u003eINFORMATION_SCHEMA\u003c/code\u003e view.\u003c/p\u003e\n"]]],[],null,["# CAPACITY_COMMITMENT_CHANGES view\n================================\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view contains a near\nreal-time list of all changes to capacity commitments within the administration\nproject. Each row represents a single change to a single capacity commitment.\nFor more information, see [Slot commitments](/bigquery/docs/reservations-workload-management#slot_commitments).\n\nRequired permission\n-------------------\n\nTo query the `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view,\nyou need the `bigquery.capacityCommitments.list` Identity and Access Management (IAM)\npermission for the project.\nEach of the following predefined IAM roles includes the required\npermission:\n\n- `roles/bigquery.resourceAdmin`\n- `roles/bigquery.resourceEditor`\n- `roles/bigquery.resourceViewer`\n- `roles/bigquery.user`\n- `roles/bigquery.admin`\n\nFor more information about BigQuery permissions, see\n[Access control with IAM](/bigquery/docs/access-control).\n\nSchema\n------\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view has the\nfollowing schema:\n\nData retention\n--------------\n\nThis view contains current capacity commitments and the deleted capacity\ncommitments that are kept for a maximum of 41 days after which they are removed\nfrom the view.\n\nScope and syntax\n----------------\n\nQueries against this view must include a [region qualifier](/bigquery/docs/information-schema-intro#syntax).\nIf you do not specify a regional qualifier, metadata is retrieved from all\nregions. The following table explains the region scope for this view:\n\nReplace the following:\n\n- Optional: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project. If not specified, the default project is used.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: any [dataset region name](/bigquery/docs/locations). For example, ```region-us```.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e\n\n | **Note:** You must use [a region qualifier](/bigquery/docs/information-schema-intro#region_qualifier) to query `INFORMATION_SCHEMA` views. The location of the query execution must match the region of the `INFORMATION_SCHEMA` view.\n\n\u003cbr /\u003e\n\nExample\n-------\n\nThe following query displays the user who has made the latest capacity commitment\nupdate to the current project within the specified date. \n\n```googlesql\nSELECT\n user_email,\n change_timestamp\nFROM\n `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES\nWHERE\n change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'\nORDER BY\n change_timestamp DESC\nLIMIT 1;\n```\n\nThe result is similar to the following: \n\n```\n+--------------------------------+-------------------------+\n| user_email | change_timestamp |\n+--------------------------------+-------------------------+\n| 222larabrown@gmail.com | 2021-09-30 09:30:00 UTC |\n+--------------------------------+-------------------------+\n\n```"]]
