BigQuery로 채널 서비스 데이터 내보내기

이 페이지에서는 채널 서비스 내보내기를 구성하는 방법뿐 아니라 내보내기에 사용 가능한 스키마에 대해서도 설명합니다.

BigQuery를 사용하면 지정된 BigQuery 데이터 세트로 채널 서비스 결제 데이터를 내보낼 수 있습니다. 이 데이터는 리셀러의 고객 또는 채널 파트너가 리셀러 제공 서비스를 사용하는 방법을 상세히 분석하는 데 도움이 됩니다.

채널 서비스에서 내보내기에는 Cloud Billing 내보내기에 포함되지 않은 리셀러별 데이터가 포함됩니다. 여기에는 비용, 크레딧, 설정된 가격 재조정 규칙이 적용된 사용 데이터가 포함됩니다. 이러한 내보내기는 또한 고객의 상위 결제 계정에 대한 모든 정보도 단일 데이터 세트로 집계합니다.

그러나 채널 서비스 내보내기의 데이터는 Cloud Billing 내보내기와 호환되므로 쿼리를 사용하여 두 데이터 세트를 조인하여 분석할 수 있습니다.

리셀러 이외의 Cloud Billing 내보내기에 대한 자세한 내용은 BigQuery로 Cloud Billing 내보내기 설정을 참고하세요.

시작하기 전에

채널 서비스 결제 데이터 내보내기를 시작하기 전에 다음을 충족해야 합니다.

• BigQuery 데이터 세트를 호스팅할 프로젝트를 설정합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
• 프로젝트에서 BigQuery Data Transfer Service API를 사용 설정해야 합니다.
• 내보낸 데이터에 대한 데이터 세트를 만들어야 합니다.

이미 Cloud Billing 데이터 내보내기를 위한 프로젝트 및 BigQuery 데이터 세트가 있는 경우, 해당 프로젝트 및 데이터 세트를 채널 서비스 내보내기에 재사용할 수 있습니다.

프로젝트 및 데이터 세트 설정에 대한 자세한 내용은 BigQuery로 Cloud Billing 데이터 내보내기 설정을 참고하세요.

내보내기에 필요한 권한

채널 서비스 내보내기를 사용 설정 및 구성하려면 다음 역할이 필요합니다.

• BigQuery의 경우 대상 데이터 세트를 만들었다면 데이터 세트가 포함된 프로젝트의 BigQuery User가 필요합니다. 데이터 세트를 다른 사용자가 만든 경우 BigQuery Data Owner 역할이 필요합니다.

• Google Cloud 내보내기를 사용 설정하려면 Partner Sales Console에서 Google Cloud 리셀러 관리자 역할이 있어야 합니다.

  Partner Sales Console에서 Google Cloud 역할 할당에 대해 알아보기

• Google Workspace 내보내기를 사용 설정하려면 리셀러 관리자이거나 Google Workspace 결제 권한이 있어야 합니다.

  Partner Sales Console에서 Google Workspace 역할 할당하기에 대해 알아보기

• (선택사항) 대상 BigQuery 데이터 세트가 포함된 프로젝트에 대한 Project Viewer: 프로젝트에 결제가 사용 설정되었는지 자동으로 확인합니다.

프로젝트 및 데이터 세트 선택하기

Partner Sales Console에서 채널 서비스 데이터를 저장할 BigQuery 프로젝트 및 데이터 세트를 선택합니다. 프로젝트에서 아직 결제를 사용 설정하지 않은 경우 결제를 사용 설정합니다.

BigQuery 데이터 세트를 만들거나 선택할 때 지원되는 BigQuery 데이터 세트 위치 중 하나를 선택할 수 있습니다. 각 데이터 소스 (Google Cloud 또는 Google Workspace)에 대해 처음으로 채널 서비스 데이터 내보내기를 사용 설정하는 경우:

• 멀티 리전 위치를 사용하도록 BigQuery 데이터 세트를 구성하면 선택한 각 데이터 소스에 대해 이전 달 초부터 BigQuery Export 데이터가 제공됩니다. 예를 들어 9월 23일에 BigQuery Export를 사용 설정하는 경우 8월 1일 시작 데이터가 내보내기에 포함됩니다.

• 리전 위치(멀티 리전 미국 또는 EU 제외)를 사용하도록 BigQuery 데이터 세트를 구성하면 선택한 각 데이터 소스에 대해 내보내기를 사용 설정한 날짜부터 BigQuery Export 데이터가 제공됩니다. 즉, BigQuery Export 데이터는 멀티 리전이 아닌 데이터 세트 위치에 대해 소급적으로 추가되지 않으므로 내보내기를 사용 설정하기 전의 BigQuery Export 데이터는 표시되지 않습니다.

여러 Partner Sales Console 계정의 결제 데이터를 내보내려면 다음 단계를 따르세요.

1. 데이터를 내보내려는 BigQuery 데이터 세트에서 각 Partner Sales Console 계정의 결제 관리자에게 데이터 세트를 볼 수 있는 권한이 있는지 확인합니다.
2. 각 Partner Sales Console 계정에서 결제 데이터 내보내기를 설정할 때 통합 데이터 세트를 선택합니다.

지원되는 BigQuery 위치

BigQuery에서 지원하는 리전에는 두 가지 유형이 있습니다.

멀티 리전

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 멀티 리전이 나와 있습니다.

리전

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 미주의 리전이 나열되어 있습니다.

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 아시아 태평양의 리전이 나열되어 있습니다.

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 유럽의 리전이 나열되어 있습니다.

내보내기 사용 설정하기

데이터 내보내기를 활성화하기 전에 정규화된 데이터 세트 ID(형식: PROJECT_ID:DATASET_NAME)를 기록해 두세요.

채널 서비스 내보내기를 사용 설정하려면 다음 단계를 따르세요.

1. Partner Sales Console에서 결제 페이지를 엽니다.
2. 결제 내보내기를 선택합니다.
3. 재결제 데이터 세트 필드에 정규화된 데이터 세트 ID를 입력합니다.
4. 데이터를 내보낼 데이터 소스를 선택합니다.
5. 업데이트를 클릭합니다. 데이터 세트 권한을 업데이트하라는 메시지가 표시되면 업데이트를 클릭합니다.

설정을 완료한 결제 내보내기는 일별 증분 사용 데이터를 제공합니다. 내보내기 테이블은 계정의 결제 내보내기를 처음 실행한 후에 표시됩니다. 데이터 세트에는 데이터를 보관하도록 처음 구성한 시점의 데이터가 포함되어 있습니다.

데이터 세트로의 재결제 비용 데이터 내보내기를 중지하려면 고객 재결제 페이지에서 결제 데이터 내보내기 사용 중지를 클릭합니다. 내보내기를 다시 활성화하려면 이전 단계에 따라 데이터 세트 ID를 지정하세요.

재결제 비용 데이터는 사용 중지된 기간에는 제공되지 않을 수 있습니다. 해당 기간 동안 내보낸 데이터를 삭제한 경우, 삭제된 레코드를 백필할 수 없습니다.

필수 서비스 계정 권한

채널 서비스 데이터 내보내기는 Google에서 소유하고 관리하며 결제 레코드를 테이블에 쓸 권한이 있는 서비스 계정을 사용합니다. 서비스 계정은 다음과 같습니다.

cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

이 서비스 계정에는 내보내기를 허용하도록 사전 정의된 역할: roles/bigquery.dataEditor이(가) 필요합니다. 내보내기를 활성화하는 단계에 따라 권한을 구성할 수 있습니다.

데이터를 효율적으로 쿼리

BigQuery 테이블은 기본적으로 export_time 기준 파티셔닝되고 payer_billing_account_id 기준 클러스터링됩니다. 즉, 테이블이 더 작은 파티션으로 나뉘고 각 파티션은 다시 더 작은 클러스터로 나뉩니다. 쿼리에서 파티셔닝 및 클러스터링 키를 사용하면 BigQuery가 관련 데이터를 빠르게 찾을 수 있으므로 쿼리 비용이 크게 절감됩니다.

예를 들어 이 쿼리는 파티셔닝 및 클러스터링 키가 없는 쿼리와 비교할 때 효율적입니다.

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

파티셔닝, 클러스터링, 권장사항에 대한 자세한 내용은 다음 링크를 참조하세요.

1. 파티셔닝된 테이블 쿼리
2. 클러스터링된 테이블 쿼리
3. 쿼리 계산 최적화
4. BigQuery의 비용 관리 권장사항

지급자 결제 계정 ID 찾기

지급자의 결제 계정 ID를 찾으려면 Partner Sales Console의 결제 계정 페이지를 열고 파트너 결제 탭을 클릭합니다.

모든 결제 계정과 지급자 결제 계정 ID를 확인할 수 있습니다.

내보내기 데이터 세트에서 다른 사용자에 대한 액세스 제어 설정하기

BigQuery Export의 데이터에 대한 액세스 제어를 설정하는 방법에는 여러 가지가 있습니다. 자세한 내용은 BigQuery 액세스 제어를 참고하세요.

사용자가 보기 권한이 있는 데이터에만 액세스할 수 있도록 하려면 내보낸 데이터 세트의 데이터를 공유하도록 승인된 뷰를 설정하는 것이 좋습니다.

지속적 데이터 내보내기의 경우 사용자의 권한을 설정할 때 서비스 계정 cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com에 항상 내보내기 데이터 세트에 대한 전체 편집자 액세스 권한이 있는지 확인합니다.

테이블 스키마

다음 스키마는 BigQuery 테이블의 데이터를 설명합니다.

BigQuery 데이터 세트에서 자세한 재결제 내보내기는 reseller_billing_detailed_export_v1(이)라는 데이터 테이블에 로드됩니다.

스키마에 대한 추가 참고사항

스키마에 관한 몇 가지 추가 참고사항이 있습니다.

Google Workspace에 적용되지 않는 열

열 또는 필드가 제품군에 적용되지 않는 경우 이 제품군의 내보낸 데이터에서 이 필드에는 null이(가) 포함됩니다. 다음 필드는 Google Workspace 내보내기에 적용되지 않습니다.

• project
• labels
• resource
• credits
• adjustmentsInfo
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Google Workspace 종량제 SKU에 적용되지 않는 열

열 또는 필드가 제품군에 적용되지 않는 경우 이 제품군의 내보낸 데이터에서 이 필드에는 null이(가) 포함됩니다. 다음 필드는 Google Workspace 내보내기에 적용되지 않습니다.

• service.id
• sku.id
• project
• labels
• resource
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name
• subscription

오프라인 주문에 적용되지 않는 열 (미리보기)

열 또는 필드가 제품군에 적용되지 않는 경우 이 제품군의 내보낸 데이터에서 이 열 또는 필드에는 null이(가) 포함됩니다. 다음 열 또는 필드는 오프라인 주문 결제 내보내기에 적용되지 않습니다.

• project
• labels
• system_labels
• location
• resource
• credits
• entitlement_name
• channel_partner_name
• channel_partner_cost
• customer_name
• customer_cost
• cost_at_list
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Google Workspace 내보내기에 대한 기타 참고사항

Google Workspace 내보내기에는 몇 가지 특별한 동작이 있습니다.

• Google Workspace 데이터에는 리셀러의 자체 사용량이 포함되지 않습니다.
• cost_type이 tax 및 adjustment이면 usage.amount_in_pricing_units은 항상 1입니다.
• Google Workspace 인보이스에서 세금은 하나의 항목으로 표시됩니다. 내보내기에서 세금은 고객별로 구분됩니다. 총 세금은 인보이스와 일치하지만 개별 세금은 반올림으로 인해 약간 부정확할 수 있습니다.

billing_account_id

• Google Cloud의 경우 이 계정은 사용량이 연결된 Cloud Billing 계정입니다.
• Google Workspace의 경우 고객의 Cloud ID입니다.
• 오프라인 주문의 경우 고객 이름입니다.

service 및 sku

Google Workspace의 경우 이러한 열은 사용과 관련된 '제품' 및 'SKU'를 나타냅니다. 제품 및 SKU ID에 대해 자세히 알아보기

Google Workspace 소모형 SKU (Google Voice 및 Drive)의 경우 sku.id 및 service.id 열에 null이 포함됩니다.

usage_start_time 및 usage_end_time

Google Workspace 인보이스 CSV에서 이는 날짜로 표시됩니다. 내보내기에서는 타임스탬프로 표시됩니다.

• usage_start_time의 경우 시작일 0:00 PST인 구독 시작 시간입니다(포함).
• usage_end_time의 경우 종료일 다음 날 0:00 PST인 구독 종료 시간입니다(제외).

project.labels

Google Cloud의 경우 사용량이 발생한Google Cloud 프로젝트의 키-값 쌍입니다. 자세한 내용은 라벨 사용을 참고하세요.

labels

Google Cloud의 경우 사용량이 발생한 Google Cloud리소스의 키-값 쌍입니다. 자세한 내용은 라벨 사용을 참고하세요.

system_labels

• Google Cloud의 경우 사용량이 발생한Google Cloud 리소스의 키-값 쌍입니다. 자세한 내용은 사용 가능한 시스템 라벨을 참고하세요.

• Google Workspace의 경우 비용과 관련된 추가 메타데이터가 있습니다.

  • workspace.googleapis.com/domain_name: 고객의 도메인 이름
  • workspace.googleapis.com/order_id: 주문 ID
  • workspace.googleapis.com/purchase_order_id: 구매주문서(PO) ID
  • workspace.googleapis.com/subscription_id: 구독 ID
  • workspace.googleapis.com/usage_type: 사용 유형. cost_type이 regular가 아니면 적용되지 않습니다.

Google Workspace 사용 유형에는 다음이 포함됩니다.

• COMMITMENT_TERM_START_ITEM: 정기 결제의 시작. 일반적으로 월 단위로 청구되는 약정 구독과 선불 구독의 결제 또는 계약 기간에 대해 당월의 실제 가입 기간(일수)과 연결됩니다.
• COMMITMENT_TERM_END_ITEM: 정기 결제 종료. 일반적으로 월 단위로 청구되는 약정 구독의 마지막 달 요금과 연결됩니다.
• COMMITMENT_TERM_RENEWAL_ITEM: 후속 정기 결제 기간의 시작
• COMMITMENT_MONTHLY_ITEM: 매월 초에 존재하는 약정에 대한 기록된 사용량. 대부분의 경우 요금에 전체 월이 포함됩니다.
• COMMITMENT_SEATS_CHANGE_ITEM: 약정 수준이 변경될 때 기록됩니다(증가 또는 감소). 대개 월 중간에 시작하여 월 단위 청구 약정 구독의 경우 월말까지, 선불 구독의 경우 결제 또는 계약 기간이 종료될 때까지 연장됩니다.
• COMMITMENT_CANCEL_ITEM: 정기 결제가 취소될 때 기록됩니다. 조기 해지와 관련된 요금이 포함됩니다. 계약이 중도 해지된 경우 남은 계약 기간에 대한 요금 또는 계약이 중도 변경 또는 취소된 경우 남은 결제 기간에 대해 발행된 크레딧을 나타냅니다.
• FLEXIBLE_SEATS_ITEM: 일정 일수 동안 연속된 블록에 대해 일정 수의 사용자별 사용량을 기록합니다. 약정이 없는 사용자만 이용할 수 있습니다.
• COUPON_DISCOUNT_ITEM: 쿠폰과 연결된 할인 금액
• MIGRATED_CREDIT_ITEM: postini 마이그레이션의 크레딧
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: 약정 선불 구독의 전체 주기에 대한 결제 주기가 시작될 때 생성되는 사용량 정보

usage.amount

Google Workspace 사용 가능한 라이선스 수 기반 사용량의 경우, 사용 가능한 유료 라이선스 수(예: 약정 요금제의 약정된 라이선스 수 또는 탄력 요금제의 유료 라이선스 수)를 나타냅니다.

Google Workspace 소비형 SKU(Google Voice 및 Drive)의 경우 사용된 시간(분)입니다.

usage.pricing_unit

• Google Cloud의 경우 Cloud Billing Catalog API에 대해 자세히 알아보세요 {: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
• Google Workspace의 경우 count입니다.

credits.id

Google Cloud의 경우 영숫자로 된 고유 식별자(12-b34-c56-d78) 또는 크레딧 유형(약정 사용 할인: CPU)에 대한 설명입니다. credits.id 필드가 비어 있으면 제품 SKU가 크레딧과 연결되지 않은 것입니다.

credits.full_name

Google Cloud의 경우 인간이 읽을 수 있는 영숫자 credits.id에 대한 설명입니다. 예를 들어 무료 체험판 크레딧 또는 지출 기반 약정 사용 할인이 있습니다. credits.full_name 값은 영숫자 credits.id인 SKU에만 채워집니다. credits.id 값이 크레딧 유형(예: 약정 사용 할인: CPU)에 대한 설명인 경우 credits.full_name 필드는 빕니다.

credits.type

Google Cloud의 경우 크레딧 유형은 다음과 같습니다.

• COMMITTED_USAGE_DISCOUNT: Compute Engine용 리소스 기반 약정 사용 계약을 구매하면 VM 사용 요금이 대폭 할인됩니다.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: 최소 금액을 지출하겠다는 약정 하에 서비스를 위해 구매한 지출 기반 약정 사용 계약입니다.
• DISCOUNT: 할인 크레딧 유형은 계약상의 지출 기준액에 도달한 후 받은 크레딧에 사용됩니다. Partner Sales Console에서 사용할 수 있는 Cloud Billing 보고서에는 할인 크레딧 유형이 지출 기반 할인(약정)으로 표시됩니다.
• FREE_TIER: 일부 서비스는 지정된 한도까지 리소스 사용량을 무료로 제공합니다. 이러한 서비스의 경우 무료 등급 사용을 구현하기 위해 크레딧이 적용됩니다.
• PROMOTION: 프로모션 크레딧 유형에는 Google Cloud 무료 체험 및 마케팅 캠페인 크레딧 또는 Google Cloud사용을 위한 기타 지원금이 포함됩니다. 가능한 경우, 프로모션 크레딧은 결제 수단으로 간주되어 자동으로 적용되며 총 청구액이 줄어듭니다.
• RESELLER_MARGIN: 리셀러인 경우 리셀러 마진 크레딧 유형은 적합한 모든 항목에서 얻은 리셀러 프로그램 할인을 나타냅니다.
• SUBSCRIPTION_BENEFIT: 할인을 받기 위해 서비스 장기 구독을 구매하여 얻은 크레딧입니다.
• SUSTAINED_USAGE_DISCOUNT : 지속 사용 할인 크레딧 유형은 결제 월의 상당 부분에서 특정 Compute Engine 리소스를 실행할 때 자동으로 받는 할인입니다.

adjustmentsInfo

Google Cloud의 경우 이러한 값은 Cloud Billing 수정을 위해 비용 항목이 생성된 경우에만 채워집니다. adjustmentsInfo 유형에는 해당 조정이 오류 정정을 위한 것이든 다른 사유로 인한 것이든 조정에 대한 세부정보가 포함됩니다.

adjustmentsInfo.adjustment_type

Google Cloud의 경우 다음이 포함됩니다.

• USAGE_CORRECTION: 잘못 보고된 사용량으로 인한 정정입니다.
• PRICE_CORRECTION: 잘못된 가격 책정 규칙으로 인한 정정입니다.
• METADATA_CORRECTION: 비용을 변경하지 않고 메타데이터를 변경하는 정정입니다.
• GOODWILL: 고객에게 호의로 발급하는 크레딧입니다.
• SALES_BASED_GOODWILL: 계약에 따라 고객에게 호의로 발급하는 크레딧입니다.
• SLA_VIOLATION: 서비스 수준 목표(SLO) 위반으로 인해 고객에게 발급된 크레딧입니다.
• BALANCE_TRANSFER: 결제 계정 간의 이체에 대한 조정입니다.
• ACCOUNT_CLOSURE: 폐쇄된 계정의 잔액을 0으로 전환하기 위한 조정입니다.
• GENERAL_ADJUSTMENT: 일반적인 Cloud Billing 계정 수정입니다.

adjustmentsInfo.adjustment_mode

Google Cloud의 경우 다음이 포함됩니다.

• PARTIAL_CORRECTION: 이 정정 사항은 원래의 사용량과 비용을 일부 무효화합니다.
• COMPLETE_NEGATION_WITH_REMONETIZATION: 이 정정 사항은 원래의 사용량과 비용을 완전히 무효화하고 업데이트된 사용량과 비용을 포함하여 정정된 항목을 발행합니다.
• COMPLETE_NEGATION: 이 정정 사항은 원래의 사용량과 비용을 완전히 무효화하며 추가 사용량에 대해서는 다시 과금하지 않습니다.
• MANUAL_ADJUSTMENT: 조정이 비용 및 사용량에 수동으로 할당됩니다.

price.effective_price

Google Cloud의 경우Google Cloud 또는 Google Maps Platform SKU 사용 및 SKU 가격 등급에 대해 청구되는 가격입니다. Cloud Billing 계정에 맞춤 계약 가격이 있는 경우 이 가격은 Cloud Billing에만 적용됩니다. 그렇지 않은 경우 SKU 또는 SKU 등급의 정가입니다.