Schéma :: ORGANIZATION_USAGE

Vue MARKETPLACE_PAID_USAGE_DAILY¶

Vous pouvez utiliser la vue MARKETPLACE_PAID_USAGE_DAILY du schéma ORGANIZATION_USAGE pour interroger l’historique quotidien de votre utilisation des annonces payantes. Récupérez le nombre de requêtes exécutées par les utilisateurs de votre compte sur des annonces individuelles, avec les frais d’utilisation.

La vue inclut cet historique pour tous les comptes de votre organisation Snowflake.

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.
CONSUMER_ACCOUNT_NAME	VARCHAR	Nom du compte du consommateur.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Localisateur du compte du consommateur. Pour plus d’informations sur les identificateurs de compte, voir identificateur de compte.
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 24 heures (1 journée).
Les données sont conservées pendant 365 jours (1 an).

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.organization_usage.marketplace_paid_usage_daily
GROUP BY 1,2,3;

Copy

Récupérer le montant total facturé par mois, par annonce et par compte de consommateur :

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, consumer_account_name
, consumer_account_locator
, listing_display_name
, listing_global_name
, SUM(charge) AS charge
FROM snowflake.organization_usage.marketplace_paid_usage_daily
GROUP BY 1,2,3,4,5;

Copy