CAPACITY_COMMITMENT_CHANGES 뷰
INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 뷰에는 관리 프로젝트 내 용량 약정의 모든 변경사항에 대한 거의 실시간 목록이 포함됩니다. 각 행은 단일 용량 약정에 대한 단일 변경사항을 나타냅니다.
예약에 대한 자세한 내용은 약정을 참조하세요.
필요한 권한
INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES 뷰를 쿼리하려면 프로젝트에 대한 bigquery.capacityCommitments.list Identity and Access Management(IAM) 권한이 필요합니다.
사전 정의된 다음 IAM 역할에는 각각 필수 권한이 포함되어 있습니다.
roles/bigquery.resourceAdminroles/bigquery.resourceEditorroles/bigquery.resourceViewerroles/bigquery.userroles/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 | +--------------------------------+-------------------------+