Schéma :: DATA_SHARING_USAGE

Vue MARKETPLACE_PAID_USAGE_DAILY¶

En tant que consommateur, vous pouvez utiliser la vue MARKETPLACE_PAID_USAGE_DAILY dans le schéma DATA_SHARING_USAGE pour interroger l’historique quotidien de votre utilisation d’une annonce payante spécifique. Récupérez les frais d’utilisation et le nombre de requêtes exécutées par vos utilisateurs sur des annonces spécifiques.

Cette vue comprend l’historique des paiements des consommateurs pour une annonce spécifique.

Note

Dans le cadre de l’avant-première de Custom Event Billing, la colonne CHARGE_TYPE contient des valeurs supplémentaires.

Colonnes¶

Nom de la colonne	Type de données	Description
REPORT_DATE	DATETIME	Date à laquelle le rapport a été exécuté.
USAGE_DATE	DATETIME	Date d’utilisation.
PROVIDER_NAME	VARCHAR	Nom d’affichage du fournisseur dans l’annonce.
PROVIDER_ACCOUNT_NAME	VARCHAR	Nom du compte du fournisseur.
PROVIDER_ACCOUNT_LOCATOR	VARCHAR	Localisateur du compte du fournisseur. Pour plus d’informations sur les identificateurs de compte, voir identificateur de compte.
PROVIDER_ORGANIZATION_NAME	VARCHAR	Nom de l’organisation du fournisseur.
LISTING_DISPLAY_NAME	VARCHAR	Nom d’affichage de l’annonce.
LISTING_GLOBAL_NAME	VARCHAR	Nom global de l’annonce.
DATABASE_NAME	VARCHAR	Nom de la base de données associée à cette annonce.
PO_NUMBER	VARCHAR	Numéro du bon de commande associé à cette annonce.
PRICING_PLAN	VARIANT	Valeur JSON qui comprend les spécificités du plan tarifaire. Uniquement inclus dans la sortie pour une utilisation payante.
CHARGE_TYPE	VARCHAR	Type de frais évalué. Pour plus d’informations sur les composantes du modèle tarifaire des annonces payantes, voir Modèles de tarification des annonces payantes. Valeurs possibles : `SAMPLE` : aucun frais. Les requêtes ont été exécutées pendant la période d’essai de l’annonce. `FIXED` : frais mensuels `GRACE` : aucun frais. Les requêtes ont été comptées parmi les requêtes gratuites autorisées au cours du mois civil (après la première requête) avant l’application du tarif par requête. `VARIABLE` : frais par requête. `MAX_VARIABLE_USAGE_REACHED` : aucun frais. Les requêtes ont été exécutées après que le coût mensuel total maximum pour cette annonce a été atteint. Les valeurs supplémentaires font partie de la fonctionnalité en avant-première : `NON_MONETIZABLE_BILLING_EVENTS` : aucun frais. Ces événements facturables ont été émis lors de l’utilisation à titre d’essai d’un produit de données, ou pour des événements facturables ne faisant pas partie d’un plan tarifaire sur l’annonce. `MONETIZABLE_BILLING_EVENTS` : frais de Custom Event Billing. `MAX_BILLING_EVENT_USAGE_REACHED` : aucun frais. Ces événements facturables ont été émis après que le coût mensuel total maximum de l’annonce a été atteint.
UNITS	VARCHAR	Nombre de requêtes incluses dans les frais. Pour des frais `FIXED`, cette valeur est de `1`.
UNIT_PRICE	DECIMAL	Frais par mois ou par requête. Pour les données échantillons, la valeur est de `0`.
CHARGE	DECIMAL	Frais totaux de cet élément de ligne pour ce jour (hors taxes).
CURRENCY	VARCHAR	USD

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 48 heures (2 journées).
Les données sont conservées pendant 365 jours (1 an).
Vous ne pouvez voir que l’utilisation de votre compte, qui doit être le compte consommateur qui a généré les frais.

Exemples¶

Récupérer le montant total facturé par mois et par annonce :

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

Récupérer le montant total facturé par mois, par annonce et par type de frais :

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

Récupérer le montant total facturé pour l’utilisation d’une application qui utilise le plan tarifaire de Custom Event Billing :

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