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