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