将渠道服务数据导出到 BigQuery

本页介绍了如何配置渠道服务导出，还介绍了导出操作的可用架构。

您可以使用 BigQuery 将渠道服务结算数据导出到指定的 BigQuery 数据集。这些数据可帮助您详细分析客户或渠道合作伙伴如何使用您提供的服务。

通过渠道服务导出的数据包含 Cloud Billing 导出数据中未包含的转销商专用数据。这类数据包括费用、赠送金额以及您配置的重新定价规则的使用情况数据。这些导出内容还会将有关客户父级结算账号的所有信息汇总到一个数据集中。

不过，渠道服务导出的数据与 Cloud Billing 导出的数据兼容，您可以使用查询将这两个数据集联接起来进行分析。

如需了解非转销商 Cloud Billing 导出功能，请参阅设置将 Cloud Billing 数据导出到 BigQuery。

准备工作

在开始导出渠道服务结算数据之前，您必须满足以下条件：

• 设置一个项目来托管您的 BigQuery 数据集，确保该项目的结算功能已启用。
• 在项目中启用 BigQuery Data Transfer Service API。
• 为导出的数据创建数据集。

如果您已为Cloud Billing 数据导出创建项目和 BigQuery 数据集，则可以将该项目和数据集用于渠道服务导出。

如需详细了解如何设置项目和数据集，请参阅设置将 Cloud Billing 数据导出到 BigQuery 的功能。

导出所需的权限

如需启用和配置渠道服务导出功能，您需要拥有以下角色：

• 对于 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/docs/datasets-intro) 使用多区域位置，则系统会从上月初开始为每个所选数据源提供 BigQuery Export 数据。例如，如果您在 9 月 23 日启用了 BigQuery 导出，则导出内容将包含从 8 月 1 日开始的数据。

• 如果您配置了 [BigQuery

  数据集](/bigquery/docs/datasets-intro) 使用区域位置（多区域美国或欧盟除外），则您选择的每个数据源的 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 导出的数据中设置访问权限控制。如需了解详情，请参阅 BigQuery 访问权限控制。

为确保用户只能访问他们有权查看的数据，我们建议您设置已获授权的视图，以便共享导出的数据集中的数据。

对于持续数据导出，在为用户设置权限时，请确保服务账号 cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com 始终对导出的数据集拥有完整的“Editor”访问权限。

表架构

以下架构描述了 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
• transaction_type
• seller_name

不适用于线下订单的列（预览版）

如果某个列或字段不适用于某个产品系列，则为该产品系列导出的数据中会在此列或字段中包含 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
• transaction_type
• seller_name

关于 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 Identity。
• 对于线下订单，此字段是客户的姓名。

“service”和“sku”

对于 Google Workspace，这些列代表与使用情况相关的“产品”和“SKU”。详细了解商品 ID 和 SKU ID。

“usage_start_time”和“usage_end_time”

在 Google Workspace 账单 CSV 中，此字段表示为日期。在导出内容中，这些值表示为时间戳：

• 对于 usage_start_time，这是订阅的开始时间（包括该时间），即开始日期的 0:00（太平洋标准时间）。
• 对于 usage_end_time，这是订阅的结束时间（不包括该时间），即结束日期的次日凌晨 0:00（美国太平洋标准时间）。

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 基于席位的使用量，此字段表示付费席位。例如，购买承诺的承诺席位数，或弹性方案的付费席位数。

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.id 的 SKU 填充 credits.full_name 值。如果 credits.id 的值是赠金类型（如承诺使用折扣：CPU）的说明，则 credits.full_name 字段将为空。

credits.type

对于 Google Cloud，赠金类型包括：

• COMMITTED_USAGE_DISCOUNT：为 Compute Engine 购买的基于资源的承诺使用合约，以获得大幅度的虚拟机使用费折扣。
• 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：将已关闭账号的余额结清为零的调整项。
• 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 层级的定价。