CAPACITY_COMMITMENTS ビュー

INFORMATION_SCHEMA.CAPACITY_COMMITMENTS ビューには、管理プロジェクト内に存在する現在のすべての容量コミットメントを準リアルタイムで示すリストが含まれます。各行は、現在の 1 つの容量コミットメントを表します。現在の容量コミットメントとは、削除されていない保留中またはアクティブの容量コミットメントのことです。予約の詳細については、コミットメントをご覧ください。

必要な権限

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。

注: INFORMATION_SCHEMA ビューに対してクエリを実行するには、リージョン修飾子を使用する必要があります。クエリ実行のロケーションは、INFORMATION_SCHEMA ビューのリージョンと一致する必要があります。

例

次の例では、現在のプロジェクトのアクティブな容量コミットメントのリストを返します。

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