Schéma :

ORGANIZATION_USAGE

Vue MONETIZED_USAGE_DAILY

En tant que fournisseur d’annonces, la vue MONETIZED_USAGE_DAILY du schéma ORGANIZATION_USAGE vous permet d’interroger l’historique de l’utilisation quotidienne de chaque annonce par les consommateurs, y compris les frais accumulés pour l’utilisation. Pour les 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 de l’utilisation par les consommateurs pour tous les comptes de votre organisation Snowflake.

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

DATE

Date d’utilisation.

LISTING_OWNER_ACCOUNT_NAME

VARCHAR

Nom du compte du fournisseur qui possède l’annonce.

LISTING_OWNER_ACCOUNT_LOCATOR

VARCHAR

Localisateur de compte pour le compte du fournisseur qui possède l’annonce. Pour plus d’informations sur les identificateurs de compte, voir identificateur de compte.

LISTING_NAME

VARCHAR

Identificateur 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 24 heures (1 journée).

  • 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.organization_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.organization_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.organization_usage.monetized_usage_daily
GROUP BY 1,2,3,4,5,6,7;
Copy