架构：: DATA_SHARING_USAGE

PAID_LISTING_ACCESS_AND_CHANGE_LOG 视图¶

备注

CURRENT_PRICING_PLAN 列包含以星号 (*) 表示的新字段，这些字段仅适用于 Offers 预览版。

提供商可以使用数据共享使用情况架构中的此视图查询使用者的付费列表变更日志，以确定定价计划的状态以及使用者何时将无法访问付费或试用列表。

此视图将在使用者变更其定价计划、开始或结束试用列表或取消订阅时更新。

列¶

列名称	数据类型	描述
EVENT_DATE	DATETIME	行的创建日期和时间。
LISTING_NAME	VARCHAR	与定价计划关联的列表名称。
LISTING_DISPLAY_NAME	VARCHAR	列表显示名称。
LISTING_GLOBAL_NAME	VARCHAR	列表的唯一列表定位器 (ULL)。
CONSUMER_ACCOUNT_NAME	VARCHAR	使用者账户名称。
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Snowflake 使用者账户定位器。
CONSUMER_ORGANIZATION_NAME	VARCHAR	使用者组织名称。
CONSUMER_SNOWFLAKE_REGION	VARCHAR	与使用者的组织账单和送货地址相对应的 Snowflake 区域。
CURRENT_PRICING_PLAN	VARIANT	以 JSON 格式提供在 EVENT_DATE 列中指定的日期和时间内激活的定价计划的信息。可以返回以下信息： PLAN_TYPE：定价计划类型。值可以是：（SUBSCRIPTION、USAGE） PLAN_SUB_TYPE：其中之一：如果 PLAN_TYPE 为 SUBSCRIPTION：则为 INSTALLMENTS 或 FIXED 其中之一。如果 PLAN_TYPE 为 USAGE：则为 PER_QUERY、COMPUTE_POOL_SURCHARGE 或 CUSTOM_BILLING 其中之一。 FREE_QUERIES_LIMIT：在使用价格适用前，允许使用者免费查询的次数。 PER_QUERY_PRICE：基于使用情况计划的每次查询成本。 BASE_PRICE：每月基本使用费。 MAX_MONTHLY_PRICE_LIMIT：每月最高使用费。 MAX_TRIAL_DAYS_LIMIT：使用者试用的时限。 MAX_TRIAL_QUERIES_LIMIT：使用者试用的使用限制。 BILLING_DURATION_MONTHS：以月为单位的合同期限。 CUSTOM_BILLING_EVENTS：现有自定义账单事件列表。其中之一： CLASS_NAME：账单事件类名。 DISPLAY_NAME：计费事件名称。 UNIT_PRICE：每计费单位价格。 DESCRIPTION：定价方案描述。 IS_AUTO_RENEWAL_ALLOWED：表示使用者是否可以自动续订列表：`true` 或 `false`。 INSTALLMENT_SCHEDULE：分期付款方案时间表。 INSTALLMENT_DURATION_MONTHS：到期的分期付款月数。 DEFAULT_INSTALLMENT_PRICE：每期付款的一般美元金额，不包括按比例付款或预付款等例外情况。 INSTALLMENT_OVERRIDES：覆盖的分期付款列表。其中之一： INSTALLMENT_NUMBER：被覆盖的分期付款编号。 INSTALLMENT_PRICE：分期付款价格。 IS_EARLY_ACCESS_ALLOWED：使用者可以在付款前访问数据。 COMPUTE_POOL_SURCHARGES：已定义的 Snowpark Container Services (SPCS) 计算池附加费列表。其中之一： COMPUTE_POOL_NAME：计算池名称。 UNIT_PRICE：按 credit 或按小时计算的计算池使用价格。 CURRENCY：定价方案的货币为美元。 CONTRACT_TYPE：对于固定费用方案，这可以是限时的，也可以是周期性的（订阅）。对于基于使用量的方案，这始终是“按使用量付费”。 COMPUTE_POOL_SURCHARGE_TYPE：适用附加费的单位。这可以是 `HOUR` 或 `CREDIT`。 CONTRACT_DURATION_MONTHS：合同期限（以月为单位）。 INVOICE_START_PREFERENCE：指明第一张发票是在接受报价时还是在指定日期发送的。可以是以下之一：`OFFER_ACCEPTED_DATE`、`SPECIFIED_DATE` 或 `FIRST_DAY_NEXT_MONTH`。如果 `SPECIFIED_DATE` 已选中，则请参阅 `INVOICE_START_TIME`。 INVOICE_START_TIME：第一张发票的日期。 IS_DEFAULT：此字段始终存在。如果为 `true`，则表示这是定价方案附带的默认优惠。如果为 `false`，则表示这是针对特定使用者的私人优惠。 OFFER_DISPLAY_NAME：向使用者显示的优惠名称。 PRICING_PLAN_DISPLAY_NAME：向使用者显示的定价方案名称。 PAYMENT_TERMS：付款条款。 PAYMENT_TYPE：付款类型。这可以是 `FULL`（表示全额付款），也可以是 `INSTALLMENT`（表示分期付款）。 ALLOWED_PAYMENT_METHODS：允许的付款方式。 ACCESS_START_PREFERENCE：访问开始的首选项。这可以是 `OFFER_ACCEPTED_DATE` 或 `SPECIFIC_DATE` 之一。 ACCESS_START_TIME：访问开始的时间。 ACCESS_END_TIME：访问结束的日期和时间。 TARGET_CONSUMER：此优惠所针对的使用者。 STATE：报价状态。 PRODUCT_SKU：SKU 已链接到与优惠相关的定价方案。 PRICING_MODEL：指定与优惠相关的定价方案是固定费用还是使用量模式。
NEXT_PRICING_PLAN	VARIANT	以 JSON 格式提供在 `CURRENT_PRICING_PLAN_END_ON` 列中指定的日期和时间内激活的定价方案的信息。此列的 JSON 格式与 `CURRENT_PRICING_PLAN` 的格式相同。
IS_CONSUMER_AUTO_RENEWAL_ENABLED	BOOLEAN	使用者启用了自动续订。这仅适用于订阅列表。
PURCHASE_STATE	VARCHAR	列表状态。状态可以是以下其中之一：： TRIAL EXPIRED DELETED PURCHASED
CURRENT_PRICING_PLAN_START_ON	DATETIME	定价方案生效的日期和时间。
CURRENT_PRICING_PLAN_END_ON	DATETIME	当前定价方案结束的日期和时间。
TRIAL_END_ON	DATETIME	列表试用的结束日期。
ACCESS_END_ON	DATETIME	当前订阅期限结束的日期和时间。NULL 表示当前计划不是订阅计划，而是基于使用量的计划。

使用说明¶

视图的延迟时间最长可达 2 天。
数据最多保留一年。
任何列发生变更时都会创建一行。例如，当使用者变更定价方案、开始或结束试用、取消订阅或删除数据时。
数据包括至少访问过一次该列表的所有使用者，包括那些已取消其列表订阅或试用的使用者。
该视图包含有一个或多个使用者的付费 Snowflake 列表的数据。
在此报告中，每个使用者的每个列表占一行。例如，如果使用者从提供商处购买了两个列表，且每次购买都更新了三次，则视图包含六个条目。单个列表示单次特定购买的状态。
视图中不包含以下数据：
- 受限试用列表
- 免费列表 – 在 Snowflake 平台上或平台外免费提供
- 免费列表 – 在平台上免费提供，但在平台外直接向提供商付费
- 从未被使用者访问过的列表

示例¶

显示指定列表和使用者的变更日志：

SELECT
  event_date,
  listing_name,
  listing_global_name,
  consumer_account_name,
  consumer_account_locator,
  consumer_organization_name,
  current_pricing_plan,
  next_pricing_plan,
  is_consumer_auto_renewal_enabled,
  purchase_state,
  current_pricing_plan_start_on,
  current_pricing_plan_end_on,
  trial_end_on,
  access_end_on
FROM snowflake.data_sharing_usage.paid_listing_access_and_change_log
WHERE TRUE
  AND consumer_organization_name = 'specific_organization_name'
  AND listing_display_name = 'specific_listing_display_name'
ORDER BY event_date DESC;

Copy

显示定价方案在下一个计费期结束的列表和使用者：

SELECT
  event_date,
  listing_name,
  listing_global_name,
  consumer_account_name,
  consumer_account_locator,
  consumer_organization_name,
  current_pricing_plan,
  next_pricing_plan,
  is_consumer_auto_renewal_enabled,
  purchase_state,
  current_pricing_plan_start_on,
  current_pricing_plan_end_on,
  trial_end_on,
  access_end_on
FROM snowflake.data_sharing_usage.paid_listing_access_and_change_log
WHERE TRUE
  AND consumer_organization_name = 'specific_organization_name'
  AND listing_display_name = 'specific_listing_display_name'
QUALIFY TRUE
  AND ROW_NUMBER() OVER (
   PARTITION BY
    consumer_organization_name,
    consumer_snowflake_region,
    consumer_account_name,
    listing_display_name
ORDER BY event_date DESC ) = 1;

Copy