架构：: DATA_SHARING_USAGE

MARKETPLACE_PAID_USAGE_DAILY 视图¶

作为使用者，您可以使用 DATA_SHARING_USAGE 架构中的 MARKETPLACE_PAID_USAGE_DAILY 视图查询付费列表的日常使用历史记录。检索用户在特定列表上执行查询的使用费用和查询次数。

该视图包括使用者查询特定列表的付款记录。

备注

作为自定义事件计费预览版的一部分，CHARGE_TYPE 列包含附加值。

列¶

列名称	数据类型	描述
REPORT_DATE	DATETIME	运行报告的日期。
USAGE_DATE	DATETIME	使用日期。
PROVIDER_NAME	VARCHAR	列表中的提供商显示名称。
PROVIDER_ACCOUNT_NAME	VARCHAR	提供商的账户名称。
PROVIDER_ACCOUNT_LOCATOR	VARCHAR	提供商账户的账户定位器。有关账户标识符的更多信息，请参阅账户标识符。
PROVIDER_ORGANIZATION_NAME	VARCHAR	提供商的组织名称。
LISTING_DISPLAY_NAME	VARCHAR	显示列表的名称。
LISTING_GLOBAL_NAME	VARCHAR	列表的全局名称。
DATABASE_NAME	VARCHAR	与此列表相关的数据库名称。
PO_NUMBER	VARCHAR	与此列表相关的订购单号。
PRICING_PLAN	VARIANT	包括定价方案具体内容的 JSON 值。仅包含在付费使用的输出值中。
CHARGE_TYPE	VARCHAR	已评估的收费类型。有关付费列表定价模型组成部分的更多信息，请参阅付费列表定价模式。可能的值如下： `SAMPLE`：不收取费用。这些查询是在列表试用期内执行的。 `FIXED`：按月收取费用。 `GRACE`：不收取费用。查询次数计入日历月内允许的免费查询次数（第一次查询后），然后再按每次查询收取费用。 `VARIABLE`：按每次查询收取费用。 `MAX_VARIABLE_USAGE_REACHED`：不收取费用。查询是在达到该列表的每月总费用上限后执行的。附加值是预览版功能的一部分： `NON_MONETIZABLE_BILLING_EVENTS`：不收取费用。这些计费事件在试用数据产品期间发生，或是不属于列表定价方案的计费事件。 `MONETIZABLE_BILLING_EVENTS`：自定义事件计费。 `MAX_BILLING_EVENT_USAGE_REACHED`：不收取费用。这些计费事件是在达到该列表的每月总费用上限后发生的。
UNITS	VARCHAR	收取的费用中包括查询次数费用。对于 `FIXED` 费用，该值为 `1`。
UNIT_PRICE	DECIMAL	每月或每次查询的费用。对于样本数据，该值为 `0`。
CHARGE	DECIMAL	该行项目当日的总费用（不含税）。
CURRENCY	VARCHAR	USD

使用说明¶

视图的延迟时间最长可达 48 小时（2 天）。
数据会保留 365 天（1 年）。
您只能看到自己账户的使用情况，账户必须是产生了费用的使用者账户。

示例¶

检索每月和每个列表的费用总额：

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, listing_display_name
, listing_global_name
, SUM(charge) AS charge
FROM snowflake.data_sharing_usage.marketplace_paid_usage_daily
GROUP BY 1,2,3;

Copy

检索每月、每个列表和每种费用类型的费用总额：

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, listing_display_name
, listing_global_name
, SUM(charge) AS charge
, charge_type
FROM snowflake.data_sharing_usage.marketplace_paid_usage_daily
GROUP BY 1,2,3,4;

Copy

检索使用自定义事件计费定价方案的应用程序所用的费用总额：

SELECT listing_global_name,
   listing_display_name,
   charge_type,
   charge
FROM SNOWFLAKE.DATA_SHARING_USAGE.MARKETPLACE_PAID_USAGE_DAILY
WHERE charge_type='MONETIZABLE_BILLING_EVENTS';

Copy