INFORMATION_SCHEMA.BI_CAPACITIES ビュー

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

必要な権限

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

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

スキーマ

INFORMATION_SCHEMA.BI_CAPACITIES ビューをクエリすると、現在の BI Engine の容量を示す 1 つの行がクエリ結果に含まれます。

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

列名 データ型 値
project_id STRING BI Engine の容量を含むプロジェクトのプロジェクト ID。
project_number INTEGER BI Engine の容量を含むプロジェクトのプロジェクト番号。
bi_capacity_name STRING オブジェクトの名前。現在、1 つのプロジェクトにつき 1 つの容量しか存在できないため、名前は常に default になります。
size INTEGER BI Engine RAM（バイト単位）
preferred_tables REPEATED STRING この BI Engine の容量を使用する必要がある優先テーブルのセット。null に設定した場合、現在のプロジェクト内のすべてのクエリに BI Engine の容量が使用されます。

スコープと構文

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

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

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

例

-- Returns current state of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITIES;

例

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

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

次の例は、ID が「my-project-id」のプロジェクト内の BI Engine の現在の状態を示します。

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

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

  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  |  project_id   | project_number | bi_capacity_name |     size     |                                               preferred_tables                                |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  | my-project-id |   123456789000 | default          | 268435456000 | "my-company-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+

次の例は、クエリ プロジェクトの BI Engine 容量のサイズをギガバイト単位で返します。

SELECT
  project_id,
  size/1024.0/1024.0/1024.0 AS size_gb
FROM `region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

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

  +---------------+---------+
  |  project_id   | size_gb |
  +---------------+---------+
  | my-project-id |  250.0  |
  +---------------+---------+