Schéma :: DATA_SHARING_USAGE

Vue PAID_LISTING_ACCESS_AND_CHANGE_LOG¶

Les fournisseurs peuvent utiliser cette vue dans le schéma Utilisation de Data Sharing pour interroger le journal des modifications des annonces payantes d’un consommateur afin de déterminer le statut d’un plan tarifaire et le moment où les consommateurs perdront l’accès aux annonces payantes ou à essai.

Cette vue est mise à jour lorsqu’un consommateur change de plan tarifaire, commence ou termine une annonce d’essai, ou lorsqu’il annule un abonnement.

Colonnes¶

Nom de la colonne	Type de données	Description
EVENT_DATE	DATETIME	Date et heure de création de la ligne.
LISTING_NAME	VARCHAR	Nom de l’annonce associée au plan tarifaire.
LISTING_DISPLAY_NAME	VARCHAR	Nom d’affichage de la l’annonce.
LISTING_GLOBAL_NAME	VARCHAR	Localisateur unique (ULL) pour l’annonce.
CONSUMER_ACCOUNT_NAME	VARCHAR	Nom du compte consommateur.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Localisateur du compte consommateur Snowflake.
CONSUMER_ORGANIZATION_NAME	VARCHAR	Nom de l’organisation du consommateur.
CONSUMER_SNOWFLAKE_REGION	VARCHAR	Région Snowflake qui correspond aux adresses de facturation et d’expédition de l’organisation du consommateur.
CURRENT_PRICING_PLAN	VARIANT	Informations au format JSON sur le plan tarifaire qui était actif à la date et à l’heure spécifiées dans la colonne EVENT_DATE. Les informations suivantes peuvent être renvoyées : PLAN_TYPE : type de plan tarifaire. Les valeurs peuvent être : (SUBSCRIPTION, USAGE) PLAN_SUB_TYPE : une des options : Si PLAN_TYPE est SUBSCRIPTION : une des options : INSTALLMENTS ou FIXED. Si PLAN_TYPE est USAGE : une des options : PER_QUERY, COMPUTE_POOL_SURCHARGE ou CUSTOM_BILLING. FREE_QUERIES_LIMIT : nombre de requêtes gratuites auxquelles un consommateur a droit avant qu’un prix d’utilisation ne s’applique. PER_QUERY_PRICE : coût par requête pour les plans basés sur l’utilisation. BASE_PRICE : frais mensuels d’utilisation de base. MAX_MONTHLY_PRICE_LIMIT : frais mensuels d’utilisation maximum. MAX_TRIAL_DAYS_LIMIT : limite de temps pour les essais consommateurs. MAX_TRIAL_QUERIES_LIMIT : limite d’utilisation pour les essais consommateurs. BILLING_DURATION_MONTHS : durée du contrat en mois. CUSTOM_BILLING_EVENTS : liste des événements de facturation personnalisés existants. Une des options : CLASS_NAME : nom de la classe de l’événement de facturation. DISPLAY_NAME : nom de l’événement de facturation. UNIT_PRICE : prix par unité facturable. DESCRIPTION : description du plan tarifaire. IS_AUTO_RENEWAL_ALLOWED : indique si le consommateur peut renouveler automatiquement l’annonce : `true` ou `false`. INSTALLMENT_SCHEDULE : planification du plan de paiement échelonné. INSTALLMENT_DURATION_MONTHS : nombre de mois de versements dus. DEFAULT_INSTALLMENT_PRICE : montant habituel en dollars de chaque paiement échelonné, à l’exclusion des exceptions telles que les paiements au prorata ou les paiements anticipés. INSTALLMENT_OVERRIDES : liste des versements annulés. Une des options : INSTALLMENT_NUMBER : numéro de versement en cours d’annulation. INSTALLMENT_PRICE : montant du versement. IS_EARLY_ACCESS_ALLOWED : les consommateurs peuvent accéder aux données avant le paiement. COMPUTE_POOL_SURCHARGES : liste des suppléments du pool de calcul définis de Snowpark Container Services (SPCS). Une des options : COMPUTE_POOL_NAME : nom du pool de calcul. UNIT_PRICE : prix par crédit ou par heure pour l’utilisation du pool de calcul. CURRENCY : devise du plan tarifaire en dollars américains.
NEXT_PRICING_PLAN	VARIANT	Informations au format JSON sur le plan tarifaire qui devient actif à la date et à l’heure spécifiées dans la colonne `CURRENT_PRICING_PLAN_END_ON`. Le format JSON pour cette colonne est identique à celui de `CURRENT_PRICING_PLAN`.
IS_CONSUMER_AUTO_RENEWAL_ENABLED	BOOLEAN	Le consommateur a activé le renouvellement automatique. Ceci n’est applicable qu’aux annonces basées sur un abonnement.
PURCHASE_STATE	VARCHAR	État des annonces. L’état peut être l’un des suivants : TRIAL EXPIRED DELETED PURCHASED
CURRENT_PRICING_PLAN_START_ON	DATETIME	Date et heure auxquelles un plan tarifaire est devenu actif.
CURRENT_PRICING_PLAN_END_ON	DATETIME	Date et heure de fin du plan tarifaire en cours.
TRIAL_END_ON	DATETIME	Date de fin de l’essai d’annonce.
ACCESS_END_ON	DATETIME	Date et heure de fin de l’abonnement en cours. NULL indique que le plan actuel n’est pas un abonnement, mais un plan basé sur l’utilisation.

Notes sur l’utilisation¶

La latence de la vue peut aller jusqu’à deux jours.
Les données sont conservées jusqu’à un an.
Une ligne est créée lorsqu’une colonne est modifiée. Par exemple, lorsqu’un consommateur change de plan tarifaire, commence ou termine un essai, annule un abonnement ou supprime les données.
Les données incluent tous les consommateurs qui ont accédé à l’annonce au moins une fois, y compris ceux qui ont annulé leur essai ou leur abonnement.
La vue contient les données des annonces payantes de Snowflake qui ont un ou plusieurs consommateurs.
Ce rapport contient une ligne par annonce et par consommateur. Par exemple, si un consommateur a acheté deux annonces auprès d’un fournisseur et que chaque achat a été mis à jour trois fois, la vue contient six entrées. Une colonne individuelle représente l’état d’un achat unique et spécifique.
Les données suivantes ne sont pas incluses dans la vue :
- Annonces à essai limité
- Annonces gratuites aussi bien sur la plateforme Snowflake qu’hors plateforme
- Annonces gratuites sur la plateforme, mais payantes hors plateforme directement au fournisseur
- Annonces jamais consultées par les consommateurs

Exemples¶

Afficher un journal des modifications pour une annonce et un consommateur donnés :

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

Afficher les annonces et les consommateurs dont les plans tarifaires se terminent au cours de la prochaine période de facturation :

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