CAPACITY_COMMITMENTS 檢視畫面
INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
檢視畫面包含管理專案中所有目前容量使用承諾的近乎即時清單。每個資料列都代表單一目前的容量使用承諾。目前的容量承諾處於待處理或有效狀態,且尚未刪除。如要進一步瞭解預留功能,請參閱「承諾使用合約」。
必要權限
如要查詢 INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
檢視畫面,您必須具備專案的 bigquery.capacityCommitments.list
身分與存取權管理 (IAM) 權限。以下每個預先定義的 IAM 角色都包含必要的權限:
roles/bigquery.resourceAdmin
roles/bigquery.resourceEditor
roles/bigquery.resourceViewer
roles/bigquery.user
roles/bigquery.admin
如要進一步瞭解 BigQuery 權限,請參閱「使用 IAM 控管存取權」
結構定義
INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
檢視表具有下列結構定義:
資料欄名稱 | 資料類型 | 值 |
---|---|---|
ddl |
STRING |
用來建立這項容量承諾的 DDL 陳述式。 |
project_id |
STRING |
管理專案的 ID。 |
project_number |
INTEGER |
管理專案的編號。 |
capacity_commitment_id |
STRING |
可唯一識別容量承諾的 ID。 |
commitment_plan |
STRING |
容量使用承諾的合約方案。 |
state |
STRING |
容量使用承諾的狀態。可以是 PENDING 或 ACTIVE 。 |
slot_count |
INTEGER |
與容量承諾相關的運算單元數量。 |
edition |
STRING |
與此預訂相關聯的版本。如要進一步瞭解版本,請參閱「BigQuery 版本簡介」。 |
is_flat_rate |
BOOL |
承諾是否與舊版固定費率容量模式或版本相關。如果為 FALSE ,則目前的承諾會與某個版本相關聯。如果是 TRUE ,承諾就是舊版固定費率容量模式。 |
renewal_plan |
STRING |
現有承諾方案結束後的新承諾方案。在合約到期前,您隨時可以變更續約方案。 |
範圍和語法
對這個檢視表執行的查詢必須包含區域限定詞。如果未指定區域限定詞,系統會從所有區域擷取中繼資料。下表說明此檢視區域範圍:
檢視表名稱 | 資源範圍 | 區域範圍 |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] |
專案層級 | REGION |
-
選用:
PROJECT_ID
: Google Cloud 專案的 ID。如果未指定,系統會使用預設專案。 -
REGION
:任一資料集區域名稱。例如:`region-us`
。
範例
以下範例會傳回目前專案的有效容量承諾清單:
SELECT capacity_commitment_id, slot_count FROM `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS WHERE state = 'ACTIVE';
結果大致如下:
+------------------------+------------+ | capacity_commitment_id | slot_count | +------------------------+------------+ | my_commitment_05 | 1000 | | my_commitment_06 | 1000 | | my_commitment_07 | 1500 | | my_commitment_08 | 2000 | +------------------------+------------+