CAPACITY_COMMITMENTS 뷰

INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 뷰에는 관리 프로젝트 내에 있는 모든 현재 용량 약정에 대한 거의 실시간에 가까운 목록이 포함됩니다. 각 행은 단일 현재 용량 약정을 나타냅니다. 현재 용량 약정이 대기 중이거나 활성 상태이며 삭제되지 않았습니다. 예약에 대한 자세한 내용은 약정을 참고하세요.

필요한 권한

INFORMATION_SCHEMA.CAPACITY_COMMITMENTS 뷰를 쿼리하려면 프로젝트에 대한 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_COMMITMENTS 뷰에는 다음과 같은 스키마가 있습니다.

열 이름 데이터 유형 값
ddl STRING 이 용량 약정을 만드는 데 사용되는 DDL 문입니다.
project_id STRING 관리 프로젝트의 ID입니다.
project_number INTEGER 관리 프로젝트의 번호입니다.
capacity_commitment_id STRING 용량 약정을 고유하게 식별하는 ID입니다.
commitment_plan STRING 용량 약정의 약정 계획입니다.
state STRING 용량 약정이 있는 상태입니다. PENDING 또는 ACTIVE일 수 있습니다.
slot_count INTEGER 용량 약정과 관련된 슬롯 수입니다.
edition STRING 이 예약과 연결된 버전입니다. 버전에 대한 자세한 내용은 BigQuery 버전 소개를 참조하세요.
is_flat_rate BOOL 약정이 기존 정액제 용량 모델이나 버전과 연결되어 있는지 여부입니다. FALSE인 경우 현재 약정이 버전과 연결된 것입니다. TRUE인 경우 약정은 기존 정액제 용량 모델입니다.
renewal_plan STRING 현재 약정 요금제가 종료된 후의 새 약정 요금제입니다. 약정이 만료되기 전에 언제든지 약정 갱신 요금제를 변경할 수 있습니다.

범위 및 구문

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

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

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

예

다음 예시는 현재 프로젝트의 활성 용량 약정 목록을 반환합니다.

SELECT
  capacity_commitment_id,
  slot_count
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
WHERE
  state = 'ACTIVE';

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

+------------------------+------------+
| capacity_commitment_id | slot_count |
+------------------------+------------+
|    my_commitment_05    |    1000    |
|    my_commitment_06    |    1000    |
|    my_commitment_07    |    1500    |
|    my_commitment_08    |    2000    |
+------------------------+------------+