计费使用情况系统表引用

本文概述了可计费使用情况系统表，包括架构和示例查询。 使用系统表时，帐户的计费使用情况数据将集中并路由到所有区域，以便你可以从工作区所在的区域查看帐户的全局使用情况。

有关使用此表监视成本和示例查询的信息，请参阅 使用系统表监视成本。

表路径：此系统表位于 system.billing.usage.

可计费使用情况表架构

可计费使用情况系统表使用以下架构：

使用情况元数据参考

usage_metadata 中的值都是字符串，它们告知您有关使用记录中涉及的工作区对象和资源的信息。

根据所使用的计算类型和功能，在任何给定的使用记录中仅填充这些值的子集。 表中的第三列显示哪些使用类型导致填充每个值。

标识元数据参考

该 identity_metadata 列提供有关使用中涉及的标识的详细信息。

• run_as 字段记录下谁运行了工作负荷。 仅针对下表中列出的特定工作负荷类型填充此值。
• 该 owned_by 字段仅适用于 SQL 仓库使用情况，并记录拥有负责使用情况的 SQL 仓库的用户或服务主体。

• 该 created_by 字段适用于 Databricks 应用和代理砖头，并记录创建应用或代理的用户的电子邮件。

run_as标识

identity_metadata.run_as 中记录的标识取决于与使用情况关联的产品。 请参考下表了解 identity_metadata.run_as 行为：

记录类型参考

billing.usage 表支持更正。 当使用情况记录的任何字段不正确且必须修复时，会发生更正。

发生更正时，Azure Databricks 会将两条新记录添加到表。 收回记录否定了原始不正确的记录，然后重述记录则包括更正的信息。 更正记录是使用 record_type 字段进行标识的：

• RETRACTION：用于否定原始不正确的使用情况。 所有字段都与 ORIGINAL 记录相同，但 usage_quantity 除外，它是一个负值，用于取消原始使用数量。 例如，如果原始记录的使用数量为259.4356，则收回记录的使用数量为-259.4356。
• RESTATEMENT：包含正确字段和使用数量的记录。

例如，以下查询返回与 job_id 相关的正确每小时使用量，即使已进行更正。 通过聚合使用数量，收回记录将否定原始记录，并且只返回重述的值。

SELECT
  usage_metadata.job_id, usage_start_time, usage_end_time,
  SUM(usage_quantity) as usage_quantity
FROM system.billing.usage
GROUP BY ALL
HAVING usage_quantity != 0

计费源产品参考

某些 Databricks 产品在同一共享 SKU 下计费。 例如，数据质量监视、预测优化和无服务器工作流都在同一无服务器作业 SKU 下计费。

为了帮助区分使用情况，billing_origin_product 和 product_features 列提供了有关与使用情况关联的特定产品与功能的更深入见解。

该 billing_origin_product 列会显示与使用记录关联的 Databricks 产品。 这些值包括：

产品功能参考

该 product_features 列是一个对象，其中包含有关所使用特定产品功能的信息，并且该列包括以下键/值对：