Référence de table système d’utilisation facturable

Cet article fournit un aperçu de la table du système d'utilisation facturable, comprenant le schéma et des exemples de requêtes. Avec les tables système, les données d’utilisation facturables de votre compte sont centralisées et routées vers toutes les régions. Vous pouvez donc afficher l’utilisation globale de votre compte à partir de la région dans laquelle se trouve votre espace de travail.

Pour plus d’informations sur l’utilisation de ce tableau pour surveiller les coûts et les exemples de requêtes, consultez Surveiller les coûts à l’aide de tables système.

Chemin d’accès de la table : cette table système se trouve à l’emplacement system.billing.usage.

Schéma du tableau d'utilisation facturable

La table système des utilisations facturables utilise le schéma suivant :

Référence de métadonnées d’utilisation

Les valeurs incluses usage_metadata sont toutes les chaînes qui vous indiquent les objets et ressources de l’espace de travail impliqués dans l’enregistrement d’utilisation.

Seul un sous-ensemble de ces valeurs est rempli dans un enregistrement d’utilisation donné, en fonction du type de calcul et des fonctionnalités utilisés. La troisième colonne du tableau indique quels types d’utilisation entraînent le remplissage de chaque valeur.

Référence de métadonnées d’identité

La identity_metadata colonne fournit plus d’informations sur les identités impliquées dans l’utilisation.

• Le champ run_as enregistre qui a exécuté la charge de travail. Ces valeurs sont remplies uniquement pour certains types de charge de travail répertoriés dans le tableau ci-dessous.
• Le owned_by champ s’applique uniquement à l’utilisation de SQL Warehouse et enregistre l’utilisateur ou le principal de service propriétaire de l’entrepôt SQL responsable de l’utilisation.

• Le created_by champ s’applique à Databricks Apps and Agent Bricks et enregistre l’e-mail de l’utilisateur qui a créé l’application ou l’agent.

identités run_as

L’identité enregistrée dans identity_metadata.run_as dépend du produit associé à l’utilisation. Référencez le tableau suivant pour le comportement identity_metadata.run_as :

Référence du type d’enregistrement

Le tableau billing.usage prend en charge les corrections. Les corrections se produisent quand un champ de l’enregistrement d’utilisation est incorrect et doit être corrigé.

Lorsqu’une correction se produit, Azure Databricks ajoute deux nouveaux enregistrements à la table. Un enregistrement de rétraction annule l’enregistrement incorrect d’origine, puis un enregistrement de reformulation inclut les informations corrigées. Les enregistrements de correction sont identifiés à l’aide du champ record_type :

• RETRACTION : utilisé pour négation de l’utilisation incorrecte d’origine. Tous les champs sont identiques à l’enregistrement ORIGINAL, à l’exception de usage_quantity, valeur négative qui annule la quantité d’utilisation d’origine. Par exemple, si la quantité d’utilisation de l’enregistrement d’origine était 259.4356, l’enregistrement de retrait aurait une quantité d’utilisation de -259.4356.
• RESTATEMENT : enregistrement qui inclut les champs corrects et la quantité d’utilisation.

Par exemple, la requête suivante retourne la quantité d’utilisation horaire correcte liée à un job_id, même si des corrections ont été apportées. En agrégeant la quantité d’utilisation, l’enregistrement de retrait annule l’enregistrement d’origine et seules les valeurs du restatément sont retournées.

SELECT
  usage_metadata.job_id, usage_start_time, usage_end_time,
  SUM(usage_quantity) as usage_quantity
FROM system.billing.usage
GROUP BY ALL
HAVING usage_quantity != 0

Référence du produit à l'origine de la facturation

Certains produits Databricks sont facturés sous la même référence SKU partagée. Par exemple, la surveillance de la qualité des données, l’optimisation prédictive et les flux de travail sans serveur sont tous facturés sous la même référence produit SKU de travaux sans serveur.

Pour vous aider à différencier l’utilisation, les colonnes billing_origin_product et product_features fournissent plus d’informations sur le produit et les fonctionnalités spécifiques associés à l’utilisation.

La colonne billing_origin_product affiche le produit Databricks associé à l’enregistrement d’utilisation. Les valeurs incluent :

Référence des fonctionnalités du produit

La colonne product_features est un objet contenant des informations sur les fonctionnalités de produit spécifiques utilisées et inclut les paires clé/valeur suivantes :