スキーマ：: DATA_SHARING_USAGE

PAID_LISTING_ACCESS_AND_CHANGE_LOG ビュー¶

プロバイダーは、 Data Sharingの更新スキーマにあるこのビューを使用して、コンシューマーの有料リスト変更ログをクエリし、料金プランのステータスと、コンシューマーがいつ有料リストまたはトライアルリストへのアクセスを失うかを判断することができます。

このビューは、コンシューマーが料金プランを変更したとき、トライアルリストを開始または終了したとき、またはサブスクリプションをキャンセルしたときに更新されます。

列¶

列名	データ型	説明
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	EVENT_DATE 列で指定された日時にアクティブであった料金プランに関する JSON 形式の情報。以下の情報が返されます。 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: コンピューティングプールの使用料は、1クレジットまたは1時間あたりの価格です。 CURRENCY: 料金プランの通貨は米ドルです。
NEXT_PRICING_PLAN	VARIANT	`CURRENT_PRICING_PLAN_END_ON` 列で指定された日時にアクティブになる料金プランに関する JSON 形式の情報。この列の 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日かかる場合があります。
データは1年間保存されます。
列が変更されると行が作成されます。たとえば、コンシューマーが料金プランを変更した場合、トライアルを開始または終了した場合、サブスクリプションをキャンセルした場合、データを削除した場合などです。
このデータには、リストサブスクリプションまたはトライアルをキャンセルした人を含め、リストに少なくとも1回アクセスしたすべてのコンシューマーが含まれます。
このビューには、1人以上のコンシューマーがいる有料のSnowflakeリストのデータが含まれます。
このレポートには、コンシューマー1人につきリスト1行が含まれます。たとえば、コンシューマーがプロバイダーから2つのリストを購入し、それぞれの購入が3回更新された場合、ビューには6つのエントリが含まれます。個々の列は、1つの特定のサブスクリプションの状態を表します。
以下のデータはビューに含まれません。
- 限定トライアルリスト
- 無料リスト - 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