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