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