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