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