CAPACITY_COMMITMENT_CHANGES 뷰

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 뷰에는 관리 프로젝트 내 용량 약정의 모든 변경사항에 대한 거의 실시간 목록이 포함됩니다. 각 행은 단일 용량 약정에 대한 단일 변경사항을 나타냅니다. 예약에 대한 자세한 내용은 약정을 참조하세요.

필요한 권한

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 뷰를 쿼리하려면 프로젝트에 대한 bigquery.capacityCommitments.list Identity and Access Management(IAM) 권한이 필요합니다. 사전 정의된 다음 IAM 역할에는 각각 필수 권한이 포함되어 있습니다.

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

BigQuery 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

스키마

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 뷰에는 다음과 같은 스키마가 있습니다.

열 이름 데이터 유형 값
change_timestamp TIMESTAMP 변경사항이 발생한 시간입니다.
project_id STRING 관리 프로젝트의 ID입니다.
project_number INTEGER 관리 프로젝트의 번호입니다.
capacity_commitment_id STRING 용량 약정을 고유하게 식별하는 ID입니다.
commitment_plan STRING 용량 약정의 약정 계획입니다.
state STRING 용량 약정이 있는 상태입니다. PENDING 또는 ACTIVE일 수 있습니다.
slot_count INTEGER 용량 약정과 관련된 슬롯 수입니다.
action STRING 용량 약정과 함께 발생한 이벤트의 유형입니다. CREATE, UPDATE, DELETE일 수 있습니다.
user_email STRING 변경을 수행한 직원 ID 제휴의 사용자 또는 주체의 이메일 주소입니다. Google이 변경한 경우는 google입니다. 이메일 주소를 모르는 경우는 NULL입니다.
commitment_start_time TIMESTAMP 현재 약정 기간의 시작 시점입니다. ACTIVE 용량 약정에만 적용됩니다. 그렇지 않으면 NULL입니다.
commitment_end_time TIMESTAMP 현재 약정 기간의 종료 시점입니다. ACTIVE 용량 약정에만 적용됩니다. 그렇지 않으면 NULL입니다.
failure_status RECORD FAILED 약정 요금제의 경우 실패 이유를 제공합니다. 그렇지 않으면 NULL입니다. RECORD는 code와 message로 구성됩니다.
renewal_plan STRING 이 용량 약정은 commitment_end_time이 지난 후에 전환됩니다. 요금제를 변경하면 약정 요금제에 따라 약정 기간이 연장됩니다. ANNUAL 및 TRIAL 약정에만 적용됩니다. 그렇지 않으면 NULL입니다.
edition STRING 이 예약과 연결된 버전입니다. 버전에 대한 자세한 내용은 BigQuery 버전 소개를 참조하세요.
is_flat_rate BOOL 약정이 기존 정액제 용량 모델이나 버전과 연결되어 있는지 여부입니다. FALSE인 경우 현재 약정이 버전과 연결된 것입니다. TRUE인 경우 약정은 기존 정액제 용량 모델입니다.

데이터 보관

이 뷰는 현재 용량 약정과 삭제된 용량 약정을 포함하며, 삭제된 약정은 최대 41일 동안 유지된 후 뷰에서 삭제됩니다.

범위 및 구문

이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다. 리전 한정자를 지정하지 않으면 모든 리전에서 메타데이터가 검색됩니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.

뷰 이름 리소스 범위 리전 범위
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES[_BY_PROJECT] 프로젝트 수준 REGION
다음을 바꿉니다.

  • (선택사항) PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.
+ REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 region-us입니다.

예

다음 쿼리는 지정된 날짜에 현재 프로젝트의 최신 용량 약정 업데이트를 수행한 사용자를 표시합니다.

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

결과는 다음과 비슷합니다.

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+