이 문서에서는 BigQuery로 매일 내보내기가 수행되는 약정 사용 할인 (CUD) 구독 메타데이터의 스키마에 대한 참조 정보를 제공합니다. 이 내보내기 기능은 지출 기반 CUD 및 유연한 절감 계획 (FSP) 약정 메타데이터의 일일 스냅샷을 BigQuery 테이블로 제공합니다. 이 테이블을 다른 결제 데이터 내보내기와 조합하여 CUD 관리 및 보고를 수행할 수 있습니다.
인그레스 및 이그레스 규칙
프로젝트 또는 조직에서 BigQuery 리소스에 대한 VPC 서비스 제어를 사용하는 경우, BigQuery에 데이터 내보내기를 올바르게 사용 설정하려면 인그레스 및 이그레스 규칙을 만들어야 합니다.
-
개별 사용자가 내보내기를 생성할 수 있도록 허용하는 인그레스 규칙을 만듭니다.
- ingressFrom: identities: - PRINCIPAL_IDENTIFIER_OF_USER_INITIATING_EXPORT sources: - accessLevel: "*" ingressTo: operations: - serviceName: bigquery.googleapis.com methodSelectors: - method: "*" resources: - projects/YOUR_PROJECT_ID_TO_HOST_EXPORT_DATA title: 'Ingress Rule Name'주 구성원 식별자 형식에 대한 자세한 내용은 주 구성원 식별자를 참조하세요.
- Google Cloud 에서 VPC 서비스 제어를 통해 BigQuery 데이터 세트에 액세스하도록 허용하는 이그레스 규칙을 만듭니다.
- egressTo: operations: - serviceName: bigquery.googleapis.com methodSelectors: - method: "*" resources: - projects/132468967293 egressFrom: identityType: ANY_IDENTITY sources: - accessLevel: "*" sourceRestriction: RESTRICTION_STATUS title: 'Egress Rule Name'
CUD 구독 내보내기 데이터의 스키마
BigQuery 데이터 세트에서 Cloud Billing 계정 CUD 구독 데이터는 cud_subscriptions_export라는 테이블에 로드됩니다.
다음 표에서는 BigQuery로 내보내는 데이터의 스키마를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
billing_account_id |
문자열 | CUD 구독 데이터와 연결된 18자리 영숫자 결제 계정 ID입니다(예: 010101-F0FFF0-10XX01). |
cud_product.id |
문자열 | 제품 정의 ID입니다(예:
344fffc1-17f9-4e34-abf2-cfffff409fa2). |
cud_product.display_name |
문자열 | 약정과 연결된 제품의 표시 이름입니다(예: Flexible Savings Plans). |
cud_product.type |
문자열 | 약정의 유형입니다(예: Spend-Based). |
consumption_model.id |
문자열 | 약정에 사용되는 가격 모델의 ID입니다(예:
5515-81A8-03A2). |
consumption_model.description |
문자열 | 약정의 가격 모델에 대한 설명입니다(예: Vertex AI FSP - 1 Year). |
subscription.entitlement_scope |
문자열 | 약정에 대한 사용 권한의 범위입니다(예:
billingAccounts/010101-F0FFF0-10XX01). |
subscription.instance_id |
문자열 | 구독 인스턴스 ID(GUID)입니다(예:
769c55ea-c50f-4258-bcf5-04b6688fa5fa). |
subscription.display_name |
문자열 | 구매 시 사용자가 정의한 약정의 표시 이름입니다. |
subscription.entitlement_period |
문자열 | 약정의 반복 기간입니다(Monthly 또는
Hourly). |
subscription.payment_terms |
문자열 | 약정의 결제 조건입니다(예: Postpay). |
region |
문자열 | 약정과 연결된 리전입니다(예:
us-central1). 약정이 전역인 경우 이 필드는
비어 있습니다. |
commitment_amount |
반복 레코드 | 약정 금액 세부정보입니다. |
commitment_amount.unit |
문자열 | 약정의 리소스 소비 측정 단위입니다(예: $/mo 또는 $/hr). |
commitment_amount.value |
숫자 | 약정 금액 값입니다. |
commitment_fee |
레코드 | 약정 수수료 세부정보입니다. |
commitment_fee.sku |
문자열 | 약정 수수료와 연결된 SKU ID입니다. |
commitment_fee.description |
문자열 | 수수료 SKU에 대한 설명입니다. |
term |
문자열 | ISO 8601 기간 형식의 약정 기간입니다. 여기서
P1Y는 1년을 나타내고 P3Y는
3년을 나타냅니다. |
start_time |
타임스탬프 | 약정의 시작 타임스탬프입니다(예:
2026-07-20 21:35:48 UTC). |
end_time |
타임스탬프 | 약정의 종료 타임스탬프입니다(예:
2027-07-20 21:35:48 UTC). |
entitlement_schedule |
반복 레코드 | 사용 권한의 일정 세부정보입니다. |
entitlement_schedule.date_start |
날짜/시간 | America/Los_Angeles 시간대 의 일정 기간 시작입니다. |
entitlement_schedule.date_end |
날짜/시간 | America/Los_Angeles 시간대의 일정 기간 종료입니다. |
entitlement_schedule.commitment_amount |
숫자 | 이 특정 일정 기간의 약정 금액입니다. |
state |
문자열 | 약정의 현재 상태입니다(Pending,
Active 또는 Expired). |