INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ビュー

INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ビューには、BI Engine の容量の変更履歴が含まれます。BI Engine 予約の現在の状態を確認するには、INFORMATION_SCHEMA.BI_CAPACITIES ビューをご覧ください。

必要な権限

INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ビューをクエリするには、BI Engine の予約に対する bigquery.bireservations.get Identity and Access Management（IAM）権限が必要です。

BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。

スキーマ

INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ビューにクエリを実行すると、現在の状態など、BI Engine の容量の更新ごとに 1 行がクエリ結果に表示されます。

INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ビューのスキーマは次のとおりです。

列名	データ型	値
`change_timestamp`	`TIMESTAMP`	BI Engine の容量が現在更新されたときのタイムスタンプ。
`project_id`	`STRING`	BI Engine の容量を含むプロジェクトのプロジェクト ID。
`project_number`	`INTEGER`	BI Engine の容量を含むプロジェクトのプロジェクト番号。
`bi_capacity_name`	`STRING`	オブジェクトの名前。現在、1 つのプロジェクトにつき 1 つの容量しか存在できないため、名前は常に `default` になります。
`size`	`INTEGER`	BI Engine RAM（バイト単位）。
`user_email`	`STRING`	変更を行ったユーザーまたは Workforce Identity 連携のサブジェクトのメールアドレス。Google による変更の場合は `google`。メールアドレスが不明な場合は `NULL`。
`preferred_tables`	`REPEATED STRING`	この BI Engine の容量を使用する必要がある優先テーブルのセット。`null` に設定した場合、現在のプロジェクト内のすべてのクエリに BI Engine の容量が使用されます。

構文

このビューに対するクエリでは、リージョン修飾子を指定する必要があります。プロジェクト ID は省略可能です。プロジェクト ID を指定しないと、クエリが実行されるプロジェクトが使用されます。

ビュー名	リソーススコープ	リージョンスコープ
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES	プロジェクトレベル	`REGION`

次のように置き換えます。

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

注: INFORMATION_SCHEMA ビューにクエリを実行するロケーションを指定する必要があります。クエリ実行のロケーションは、INFORMATION_SCHEMA ビューのリージョンと一致する必要があります。

-- Returns the history of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES;

例

次の例では、INFORMATION_SCHEMA.BI_CAPACITY_CHANGES ビューから現在の BI Engine の容量の変更を取得します。

クエリが実行されているプロジェクト以外のプロジェクトに対してクエリを実行するには、形式 `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES でプロジェクト ID をリージョンに追加します。

次の例では、ユーザーがメール email@mycompanymail.com で BI Engine の容量に対して行ったすべての変更を取得します。

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "email@mycompanymail.com"

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

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  change_timestamp   |  project_id   | project_number | bi_capacity_name |     size     |     user_email      |                                               preferred_tables                         |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  | 2022-06-14 02:22:18 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["my-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  | 2022-06-08 20:25:51 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | email@mycompany.com | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+

次の例では、過去 7 日間の BI Engine の容量の変更を取得します。

SELECT
  change_timestamp,
  size,
  user_email,
  preferred_tables
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE change_timestamp > TIMESTAMP_SUB(CURRENT_DATE(), INTERVAL 7 DAY)

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

  +---------------------+--------------+----------------------+-------------------+
  |  change_timestamp   |     size     |     user_email       |  preferred_tables |                                                                                    |
  +---------------------+--------------+----------------------+-------------------+
  | 2023-07-08 18:25:09 | 268435456000 | sundar@mycompany.com | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | pichai@mycompany.com | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+