Référence de table système d'utilisation facturable
Cet article fournit une vue d'ensemble de la table système d'utilisation facturable, y compris le schéma et des exemples de queries. Grâce aux tables système, les données d'utilisation facturable de votre compte sont centralisées et acheminées vers toutes les régions, ce qui vous permet de consulter l'utilisation globale de votre compte depuis la région où se trouve votre Workspace.
Pour obtenir des informations sur l'utilisation de cette table pour surveiller les coûts et les exemples de query, consultez Surveiller les coûts à l'aide des tables système.
**Chemin de la table** : Cette table système est située system.billing.usage à.
Schéma de la table d'utilisation facturable
La table système d'utilisation facturable utilise le schéma suivant :
Nom de colonne | Type de données | Description | Exemple |
|---|---|---|---|
| chaîne | ID unique pour cet enregistrement d'utilisation |
|
| chaîne | ID du compte pour lequel ce rapport a été généré |
|
| chaîne | ID du workspace auquel cette utilisation était associée |
|
| chaîne | Nom du SKU |
|
| chaîne | Cloud associé à cette utilisation. Les valeurs possibles sont |
|
| Horodatage | L’heure de start pertinente pour cet enregistrement d’utilisation. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, |
|
| Horodatage | L'heure de fin pertinente pour cet enregistrement d'utilisation. Les informations de fuseau horaire sont enregistrées à la fin de la valeur, |
|
| Date | Date de l’enregistrement d’utilisation, ce champ peut être utilisé pour une agrégation plus rapide par date |
|
| Carte | Balises personnalisées associées à l'enregistrement d'utilisation |
|
| chaîne | Unité de mesure de cette utilisation |
|
| décimal | Nombre d'unités consommées pour cet enregistrement |
|
| structure | Métadonnées fournies par le système concernant l'utilisation, y compris les ID pour les ressources de compute et les jobs (le cas échéant). Voir Métadonnées d'utilisation. | Consultez les métadonnées d'utilisation |
| structure | Métadonnées fournies par le système sur les identités impliquées dans l'utilisation. Consultez les métadonnées d'identité. | Consultez les métadonnées d'identité |
| chaîne | Si l'enregistrement est original, une rétractation ou une nouvelle déclaration. La valeur est |
|
| Date | Date d'ingestion de l'enregistrement dans la table |
|
| chaîne | Le produit qui a généré l'utilisation. Certains produits peuvent être facturés sous la forme de SKU différents. Pour les valeurs possibles, consultez Produit. |
|
| structure | Détails sur les fonctionnalités spécifiques du produit utilisées. Consultez les fonctionnalités du produit. | Voir les fonctionnalités du produit |
| chaîne | Le type d'utilisation attribué au produit ou à la charge de travail à des fins de facturation. Les valeurs possibles sont |
|
Référence des métadonnées d'utilisation
Les valeurs de usage_metadata sont toutes des chaînes qui vous informent sur les objets Workspace et les Ressources impliqués dans l'enregistrement d'utilisation.
Seul un sous-ensemble de ces valeurs est renseigné dans chaque enregistrement d'utilisation, en fonction du type de compute et des fonctionnalités utilisées. La troisième colonne dans le tableau montre quels types d'utilisation remplissent chaque valeur.
Valeur | Description | Renseigné pour (sinon |
|---|---|---|
| ID du cluster associé à l'enregistrement d'utilisation | Utilisation du compute non serverless, y compris les notebooks, les jobs, les Lakeflow Pipelines et la diffusion de modèles hérités |
| ID du Job associé à l'enregistrement d'utilisation | Serverless jobs et jobs exécutés sur le compute de job (ne se remplit pas pour les jobs exécutés sur le compute multifonction) |
| ID du SQL Warehouse associé à l'enregistrement d'utilisation | Les workloads s'exécutent sur un SQL Warehouse. |
| ID du Pool d'instances associé à l'enregistrement d'utilisation | Utilisation de compute non Serverless à partir de Pool, y compris les Notebook, les Job, les LakeFlow Pipelines et le service de modèles hérité. |
| Le type d'instance compute. Ce champ ne fait pas la distinction entre les nœuds Driver et Worker. Voir Type de nœud. | Utilisation de compute non Serverless, y compris les Notebooks, Jobs, Lakeflow Pipelines et tous les SQL Warehouses |
| ID de l'exécution du job associé à l'enregistrement d'utilisation | Serverless jobs et jobs exécutés sur le compute de job (ne se remplit pas pour les jobs exécutés sur le compute multifonction) |
| ID du Notebook associé à l'utilisation | Notebooks Serverless |
| ID du pipeline déclaratif associé à l'enregistrement d'utilisation | LakeFlow Pipelines et fonctionnalités utilisant les LakeFlow Pipelines, telles que les vues matérialisées, les tables en ligne, l'indexation AI Search et Lakeflow Connect |
| Le nom de l'Endpoint de service de modèle ou de l'Endpoint de recherche IA associé à l'enregistrement d'utilisation | Service de modèle et recherche IA |
| ID de l'endpoint de service de modèle ou de l'endpoint de recherche d'IA associé à l'enregistrement d'utilisation | Service de modèle et recherche IA |
| ID de la mise à jour du pipeline associée à l'enregistrement d'utilisation | LakeFlow Pipelines et fonctionnalités utilisant les LakeFlow Pipelines, telles que les vues matérialisées, les tables en ligne, l'indexation AI Search et Lakeflow Connect |
| ID des tâches de maintenance du pipeline associées à l'enregistrement d'utilisation | LakeFlow Pipelines et fonctionnalités utilisant les LakeFlow Pipelines, telles que les vues matérialisées, les tables en ligne, l'indexation AI Search et Lakeflow Connect |
| ID du metastore associé au stockage par default. | |
| Nom affiché pour l'utilisateur de l'exécution d'affinement du modèle de fondation associée à l'enregistrement d'utilisation | Affinement du modèle de fondation |
| Nom donné par l'utilisateur du Job associé à l'enregistrement d'utilisation | Les Jobs Serverless et les jobs s'exécutent sur le compute de Job (disponible pour le compute de Job depuis septembre 2025). Non renseigné pour le compute multifonction. |
| Chemin de stockage du Workspace du Notebook associé à l'utilisation | Les Notebooks s'exécutent sur le compute Serverless |
| ID de la salle blanche centrale associée à l'enregistrement d'utilisation. | Salles blanches |
| Région où le trafic facturé a été généré. Renvoie une valeur uniquement pour l'utilisation liée au réseau. | |
| Région où le trafic facturé a été reçu. Renvoie une valeur uniquement pour l'utilisation liée au réseau. | |
| ID du destinataire OpenSharing associé à l'enregistrement d'utilisation | Mise en réseau : trafic de données sortant vers les destinataires OpenSharing via OpenSharing SecureConnect |
| Le produit qui a Trigger l'utilisation. Par exemple, des frais de NETWORKING peuvent être déclenchés par une connexion à la BASE DE DONNÉES. Ce champ n'est renseigné que lorsque l'utilisation est entièrement attribuable à un produit source en amont. | Mise en réseau |
| Le client qui a entraîné l'utilisation du réseau. Peut être | Mise en réseau |
| ID de l'application associée à l'enregistrement d'utilisation | Databricks Apps |
| Nom donné par l'utilisateur de l'application associée à l'enregistrement d'utilisation | Databricks Apps |
| Cette valeur n'est pas renseignée dans Databricks sur AWS | Toujours |
| Obsolète. Utilisez plutôt | Utilisation du compute Serverless, y compris les notebooks, les jobs, les LakeFlow Pipelines et les Endpoints de déploiement de modèles |
| Le type d'Opération effectuée sur le stockage default. Les valeurs possibles sont : | |
| ID de la charge de travail GPU serverless associée à l'enregistrement d'utilisation | AI Runtime charges de travail |
| Le nom du catalogue Unity Catalog associé à l’enregistrement d’utilisation | |
| Le nom du schéma Unity Catalog associé à l’enregistrement d’utilisation | |
| Le nom de la table Unity Catalog associé à l’enregistrement d’utilisation | |
| ID de l'instance de base de données associée à l'enregistrement d'utilisation | Instances de base de données Lakebase |
| ID de la matérialisation de partage associée à l'enregistrement d'utilisation | Partage de vues, vues matérialisées et tables de streaming à l'aide d'OpenSharing |
| ID de la politique d'utilisation serverless associée à l'enregistrement d'utilisation | Politiques d'utilisation Serverless |
| ID de la charge de travail Agent Bricks associée à l'enregistrement d'utilisation | Charges de travail Knowledge Assistant Supervisor Agent |
| ID de l'environnement de base associé à l'utilisation | Utilisation provenant de la construction ou de l'actualisation de l'environnement de base serverless d'un Workspace. Rempli lorsque |
| ID du schéma associé à l'enregistrement d'utilisation | |
| ID de la table associé à l'enregistrement d'utilisation |
Type de nœud
Lorsqu'un driver et des workers de ressources compute classiques utilisent le même type d'instance, leur utilisation est combinée en un seul enregistrement. Lorsque les nœuds driver et worker du compute utilisent des types d'instances différents, leur utilisation apparaît sous forme d'enregistrements distincts : un pour le type d'instance du driver et un pour celui du worker.
Pour attribuer l'utilisation à un rôle de nœud spécifique, vous pouvez recouper usage_metadata.cluster_id dans la table d'utilisation avec les données des tables système du compute. La table system.compute.clusters enregistre les driver_node_type et worker_node_type de chaque cluster, et la table system.compute.node_timeline inclut une colonne booléenne driver qui identifie le rôle de chaque nœud.
Référence des métadonnées d'identité
La colonne identity_metadata fournit plus d'informations sur les identités impliquées dans l'utilisation.
-
Le champ
run_asLogs qui a exécuté la charge de travail. Voir le tableau suivant pour savoir comment cette valeur est renseignée pour chaque type de charge de travail. -
Le champ
owned_byne s'applique qu'à l'utilisation des SQL Warehouse et logs l'utilisateur ou le Service Principal propriétaire du SQL Warehouse responsable de l'utilisation. -
Le champ
created_bys'applique aux Databricks Apps, Knowledge Assistant et Agent superviseur. Le champ Logs 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. Reportez-vous au tableau suivant pour le comportement identity_metadata.run_as :
Type de Workload | Identité de |
|---|---|
Jobs compute | L'utilisateur ou le Service Principal défini dans le paramètre |
Serverless compute pour les jobs | L'utilisateur ou le Service Principal défini dans le paramètre |
Compute serverless pour les Notebooks | L’utilisateur qui a exécuté les commandes du Notebook (plus précisément, l’utilisateur qui a créé la session du Notebook). Pour les Notebooks partagés, cela inclut l’utilisation par d’autres utilisateurs partageant la même session de Notebook. |
Compute polyvalent | L'identité qui a créé la ressource de compute. Ce n'est pas nécessairement le propriétaire du compute. Pour attribuer l'utilisation au propriétaire, joignez-vous à |
LakeFlow Pipelines | L'utilisateur ou le Service Principal dont les autorisations sont utilisées pour exécuter le pipeline. Cela peut être modifié en transférant la propriété du pipeline. |
Affinement du modèle de fondation | L'utilisateur ou le Service Principal qui a lancé l'exécution d'entraînement de l'affinement. |
Optimisation prédictive | Le service principal appartenant à Databricks qui exécute les opérations d'optimisation prédictive. |
Contrôle qualité des données | L'utilisateur qui a créé le profil. |
Dans les workspaces activés pour la norme de conformité FedRamp, toutes les valeurs non nulles de la colonne identity_metadata seront remplacées par __REDACTED__.
Référence de type d'enregistrement
La table billing.usage prend en charge les corrections. Des corrections ont lieu lorsqu'un champ de l'enregistrement d'utilisation est incorrect et doit être corrigé.
Lorsqu'une correction se produit, Databricks ajoute deux nouveaux enregistrements à la table. Un enregistrement de rétractation annule l'enregistrement incorrect original, puis un enregistrement de rectification inclut les informations corrigées. Les enregistrements de correction sont identifiés à l'aide du champ record_type :
RETRACTION: Sert à annuler l'utilisation incorrecte originale. Tous les champs sont identiques à l'enregistrementORIGINALà l'exception deusage_quantity, qui est une valeur négative qui annule la quantité d'utilisation originale. Par exemple, si la quantité d'utilisation de l'enregistrement original était259.4356, l'enregistrement de rétractation aurait une quantité d'utilisation de-259.4356.RESTATEMENT: L'enregistrement qui inclut les champs corrects et la quantité d'utilisation.
Par exemple, la query suivante renvoie 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 rétractation annule l'enregistrement original et seules les valeurs de la nouvelle déclaration sont renvoyé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
Pour les corrections où l'enregistrement d'utilisation d'origine n'aurait pas dû être écrit, une correction ne peut qu'ajouter un enregistrement de rétractation et aucun enregistrement de redéclaration.
Référence du produit d'origine de facturation
Certains produits Databricks sont facturés sous la même SKU partagée. Par exemple, le monitoring de la qualité des données, l'optimisation prédictive et les workflows Serverless sont tous facturés sous la même SKU de Jobs Serverless.
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 indique le produit Databricks associé à l'enregistrement d'utilisation. Les valeurs incluent :
Valeur | Description |
|---|---|
| Coûts associés aux charges de travail Lakeflow Jobs |
| Coûts associés aux charges de travail des LakeFlow Pipelines |
| Coûts associés à Databricks SQL, y compris les charges de travail exécutées sur des SQL warehouses et les vues matérialisées |
| Coûts associés au compute classique polyvalent |
| Coûts associés au Model Serving |
| Coûts associés aux charges de travail interactives serverless |
| Coûts associés au default storage |
| Coûts associés à la Recherche IA |
| Coûts associés au Contrôle qualité des données |
| Coûts associés à l'optimisation prédictive |
| Coûts associés aux tables en ligne (Hérité) |
| Coûts associés à l'affinement de modèle de fondation |
| Coûts associés à l'évaluation des agents |
| Utilisation Serverless à partir d'un contrôle d'accès précis sur un compute dédié |
| Utilisation Serverless de l'ABAC inter-moteur |
| Utilisation associée à la création ou à l’actualisation de l’ environnement de base Serverlessd’un Workspace |
| Coûts associés aux opérations de classification des données |
| Coûts associés au monitoring de la qualité des données, y compris la détection d'anomalies et le profilage des données |
| Coûts associés à OpenSharing |
| Coûts associés à l'AI Gateway utilisation |
| Coûts associés aux charges de travail GPU Serverless |
| Coûts associés à la connexion du compute serverless à vos ressources, et à l'égression vers les clients pour les produits gourmands en performances. |
| Coûts associés à la création et à l'exécution de Databricks Apps |
| Coûts associés aux instances de base de données Lakebase provisionnées |
| Coûts associés à Lakebase Postgres |
| Coûts associés à l'utilisation des AI Functions. Ce produit enregistre l'utilisation pour AI_PARSE_DOCUMENT, AI_EXTRACT, AI_CLASSIFY. |
| Coûts associés aux charges de travail Knowledge Assistant Agent Superviseur |
| Coûts associés aux charges de travail des Clean Rooms. |
| Coûts associés aux connecteurs gérés Lakeflow Connect |
Référence des fonctionnalités du produit
La colonne product_features est un objet contenant des informations sur les fonctionnalités spécifiques du produit utilisées et comprend les paires clé/valeur suivantes :
Champ | Description |
|---|---|
| Les valeurs incluent |
| Les valeurs incluent |
| Les valeurs incluent |
| Les valeurs incluent |
| Les valeurs incluent |
| Les valeurs possibles sont |
| Les valeurs incluent |
| Indique le mode de performance du Job Serverless ou du pipeline. Les valeurs comprennent |
| Indique le type de compute pour les charges de travail GPU serverless ou |
| Indique le type d'offre pour la mise à disposition de modèles ou |
| Indique le type de fonctionnalité pour les charges de travail AI Gateway ou |
| Indique le type de charge de travail pour AI Runtime (GPU serverless) ou |
| Indique le type de fonction IA ou |
| Les valeurs incluent |
| Indique le type de problème pour les charges de travail de l'Assistant de connaissances. Les valeurs incluent |
| Indique le type de charge de travail pour Knowledge Assistant . Les valeurs incluent |