架构：: DATA_SHARING_USAGE

PAID_LISTING_ACCESS_AND_CHANGE_LOG 视图¶

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

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

列¶

列名称	数据类型	描述
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：定价方案的货币为美元。
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