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 용량의 현재 상태가 있는 행 하나가 포함됩니다.
INFORMATION_SCHEMA.BI_CAPACITIES
뷰에는 다음과 같은 스키마가 있습니다.
열 이름 | 데이터 유형 | 값 |
---|---|---|
project_id |
STRING |
BI Engine 용량이 포함된 프로젝트의 프로젝트 ID입니다. |
project_number |
INTEGER |
BI Engine 용량이 포함된 프로젝트의 프로젝트 번호입니다. |
bi_capacity_name |
STRING |
객체 이름입니다. 현재는 프로젝트당 용량이 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 | +---------------+---------+