INFORMATION_SCHEMA.BI_CAPACITY_CHANGE 뷰

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 용량의 업데이트마다 행이 하나씩 쿼리 결과에 포함됩니다.

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`	객체 이름입니다. 현재 프로젝트당 용량은 하나만 있을 수 있으므로 이름은 항상 `default`입니다.
`size`	`INTEGER`	BI Engine RAM(바이트)
`user_email`	`STRING`	변경을 수행한 직원 ID 제휴의 사용자 또는 주체의 이메일 주소입니다. 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"] |
  +---------------------+--------------+----------------------+-------------------+