CAPACITY_COMMITMENT_CHANGES ビュー

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES ビューには、管理プロジェクト内の容量コミットメントに対するすべての変更を準リアルタイムで示すリストが含まれます。各行は 1 つの容量コミットメントに対する 1 つの変更を表します。予約の詳細については、コミットメントをご覧ください。

必要な権限

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES ビューをクエリするには、プロジェクトの 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_COMMITMENT_CHANGES ビューのスキーマは次のとおりです。

列名 データ型 値
change_timestamp TIMESTAMP 変更が発生した時刻。
project_id STRING 管理プロジェクトの ID。
project_number INTEGER 管理プロジェクトの番号。
capacity_commitment_id STRING 容量コミットメントを一意に識別する ID。
commitment_plan STRING 容量コミットメントのコミットメント プラン。
state STRING 容量コミットメントの状態。PENDING または ACTIVE のいずれかです。
slot_count INTEGER 容量コミットメントに関連付けられたスロット数。
action STRING 容量コミットメントで発生したイベントの種類。CREATE、UPDATE、または DELETE のいずれかです。
user_email STRING 変更を行ったユーザーまたは Workforce Identity 連携のサブジェクトのメールアドレス。Google による変更の場合は google。メールアドレスが不明な場合は NULL。
commitment_start_time TIMESTAMP 現在のコミットメント期間が開始する日時。ACTIVE の容量コミットメントにのみ適用されます。それ以外の場合は NULL になります。
commitment_end_time TIMESTAMP 現在のコミットメント期間が終了する日時。ACTIVE の容量コミットメントにのみ適用されます。それ以外の場合は NULL になります。
failure_status RECORD FAILED コミットメント プランの場合は、失敗の理由を示します。それ以外の場合は NULL となります。RECORD は code と message で構成されています。
renewal_plan STRING この容量コミットメントが commitment_end_time 経過後に変換されるプラン。プランが変更された後、コミットメント プランに従って commit 期間が延長されます。ANNUAL コミットメントと TRIAL コミットメントにのみ適用されます。それ以外の場合は NULL になります。
edition STRING この予約に関連付けられているエディション。エディションの詳細については、BigQuery エディションの概要をご覧ください。
is_flat_rate BOOL コミットメントが以前のフラットレート容量モデルに関連付けられているか、エディションに関連付けられているか。FALSE の場合、現在のコミットメントはエディションに関連付けられています。TRUE の場合、コミットメントは以前のフラットレート容量モデルです。

データの保持

このビューには、現在の容量コミットメントと、ビューから削除された後最大 41 日間保持されていた、削除済みの容量コミットメントが含まれます。

スコープと構文

このビューに対するクエリでは、リージョン修飾子を指定する必要があります。リージョン修飾子を指定しない場合、メタデータはすべてのリージョンで取得されます。次の表で、このビューのリージョン スコープを説明します。

ビュー名 リソース スコープ リージョン スコープ
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES[_BY_PROJECT] プロジェクト レベル REGION
次のように置き換えます。

  • 省略可: PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
  • REGION: 任意のデータセット リージョン名。例: region-us

例

次のクエリは、指定された日付範囲内に現在のプロジェクトに対する最新の容量コミットメント更新を行ったユーザーを表示します。

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;

次のような結果になります。

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