Schéma :

DATA_SHARING_USAGE

Vue MONETIZED_USAGE_DAILY

La vue MONETIZED_USAGE_DAILY du schéma DATA_SHARING_USAGE vous permet d’interroger l’historique des requêtes quotidiennes des consommateurs par annonce, y compris les frais accumulés pour l’utilisation. Pour obtenir des informations sur les paiements des consommateurs, interrogez la vue MARKETPLACE_DISBURSEMENT_REPORT dans le schéma ORGANIZATION_USAGE ou DATA_SHARING_USAGE.

La vue comprend l’historique des requêtes des consommateurs pour une annonce spécifique.

Colonnes

Nom de la colonne

Type de données

Description

REPORT_DATE

DATETIME

Date à laquelle le rapport a été exécuté.

USAGE_DATE

DATE

Date d’utilisation.

LISTING_NAME

VARCHAR

identificateur SQL de l’annonce.

LISTING_DISPLAY_NAME

VARCHAR

Nom d’affichage de l’annonce.

LISTING_GLOBAL_NAME

VARCHAR

Nom global de l’annonce.

CONSUMER_ACCOUNT_LOCATOR

VARCHAR

Localisateur du compte du consommateur.

CONSUMER_ACCOUNT_NAME

VARCHAR

Nom du compte du consommateur.

CONSUMER_ORGANIZATION_NAME

VARCHAR

Nom de l’organisation du compte consommateur.

CONSUMER_SNOWFLAKE_REGION

VARCHAR

Région du service Cloud où le compte du consommateur est hébergé.

PRICING_PLAN

JSON

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 requêtes gratuites ou l’utilisation après avoir atteint le montant total maximum pour le mois, la valeur est 0.

GROSS_CHARGE

DECIMAL

Coût total de ce poste à ce jour.

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).

Exemples

Récupérez le nombre total de requêtes exécutées et les frais bruts totaux par client et par mois. Les requêtes sont retournées en nombre d’unités :

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, consumer_organization_name
, consumer_snowflake_region
, consumer_account_locator
, consumer_account_name
, currency
, SUM(units) AS units
, SUM(gross_charge) AS gross_charge
FROM snowflake.data_sharing_usage.monetized_usage_daily
GROUP BY 1,2,3,4,5,6;
Copy

Récupérez le nombre total de requêtes exécutées et les frais bruts totaux par annonce et par mois :

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, listing_name
, listing_display_name
, listing_global_name
, currency
, SUM(units) AS units
, SUM(gross_charge) AS gross_charge
FROM snowflake.data_sharing_usage.monetized_usage_daily
GROUP BY 1,2,3,4,5;
Copy

Récupérez le nombre total de requêtes exécutées et le total des frais bruts par type de frais, consommateur et mois :

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, consumer_organization_name
, consumer_snowflake_region
, consumer_account_locator
, consumer_account_name
, charge_type
, currency
, SUM(units) AS units
, SUM(gross_charge) AS gross_charge
FROM snowflake.data_sharing_usage.monetized_usage_daily
GROUP BY 1,2,3,4,5,6,7;
Copy