CAPACITY_COMMITMENTS 视图

INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 视图包含管理项目中所有当前的容量承诺的列表。每一行代表一个当前容量承诺。当前容量承诺处于待处理或活跃状态，尚未删除。如需详细了解预留，请参阅承诺。

所需权限

如需查询 INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 视图，您需要拥有项目的 bigquery.capacityCommitments.list Identity and Access Management (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    |
+------------------------+------------+