Aller au contenu principal

Surveillez et comprenez votre coût Genie

Cet article explique comment l'utilisation de Genie apparaît dans les tables du système de facturation Databricks, comment query et analyser vos coûts Genie, et comment les tarifs promotionnels sont reflétés dans vos données d'utilisation. Il explique également comment comprendre la consommation de l'allocation gratuite fournie par Genie : chaque utilisateur, à l'exception des Service Principal, reçoit 150 DBU gratuits par mois.

remarque

Jusqu'au 31 juillet 2026, l'utilisation de Genie One et des agents Genie est gratuite. Genie Code reste facturé au-delà de l'allocation gratuite de 150 DBU par utilisateur et par mois.

Pour en savoir plus sur la définition des budgets et les contrôles des coûts pour Genie, consultez Gérer les budgets et les contrôles des coûts pour Genie.

Utilisation de Query Genie à partir des tables système

Pour analyser l'utilisation et le coût de Genie, interrogez la table system.billing.usage et joignez-la à system.billing.list_prices. La table system.billing.usage est mise à jour toutes les quelques heures et contient une ligne pour chaque enregistrement d'utilisation.

Les colonnes suivantes sont les plus pertinentes pour comprendre le coût de Genie :

Colonne

Description

billing_origin_product

Défini à GENIE pour toute utilisation de Genie.

sku_name

La référence de facturation SKU. Varie selon que l'utilisation est gratuite ou facturée. Consultez Comment l'utilisation de Genie correspond aux SKU.

usage_quantity

Le nombre de DBUs consommés.

usage_metadata.genie.surface

Identifie quel produit Genie a généré l'utilisation (GENIE_CODE, GENIE_ONE, ou GENIE_AGENTS).

usage_metadata.genie.channel

Le Canal de distribution d'accès, par exemple UI.

identity_metadata.run_as

L'utilisateur dont l'identité a été utilisée pour exécuter la query.

product_features.genie.offering_type

Le type d'offre, par exemple : PAYGO.

custom_tags

Comprend {"databricks-product": "genie"} pour l'utilisation de Genie.

Colonne

Description

billing_origin_product

Défini à GENIE pour toute utilisation de Genie.

sku_name

La référence de facturation SKU. Varie selon que l'utilisation est gratuite ou facturée. Consultez Comment l'utilisation de Genie correspond aux SKU.

usage_quantity

Le nombre de DBUs consommés.

usage_metadata.genie.surface

Identifie quel produit Genie a généré l'utilisation (GENIE_CODE, GENIE_ONE, ou GENIE_AGENTS).

usage_metadata.genie.channel

Le Canal de distribution d'accès, par exemple UI.

identity_metadata.run_as

L'utilisateur dont l'identité a été utilisée pour exécuter la query.

product_features.genie.offering_type

Le type d'offre, par exemple : PAYGO.

custom_tags

Comprend {"databricks-product": "genie"} pour l'utilisation de Genie.

Comment l'utilisation de Genie correspond aux SKU

L’utilisation de Genie est répartie sur deux SKU selon qu’elle est gratuite ou facturée, et non en fonction du produit Genie.

SKU

Ce qu'il contient

Facturé ?

Répertorié dans list_prices?

Inference temps réel Serverless (par exemple, ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_<REGION>)

Toute utilisation de Genie facturée

Oui

Oui

GENIE_FREE_USAGE

Toute utilisation gratuite de Genie. Consultez les tarifs promotionnels pour savoir ce qui est gratuit.

Non

Non

SKU

Ce qu'il contient

Facturé ?

Répertorié dans list_prices?

Inference temps réel Serverless (par exemple, ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_<REGION>)

Toute utilisation de Genie facturée

Oui

Oui

GENIE_FREE_USAGE

Toute utilisation gratuite de Genie. Consultez les tarifs promotionnels pour savoir ce qui est gratuit.

Non

Non

Utilisez usage_metadata.genie.surface pour identifier le produit ayant généré l'utilisation : GENIE_CODE, GENIE_ONE ou GENIE_AGENTS.

Utilisation facturée : référence Serverless temps réel Inference SKU

L'utilisation de Genie qui dépasse l'allocation d'utilisation gratuite est facturée sous le SKU Serverless Inférence en temps réel . Le nom exact du SKU inclut votre cloud et votre région, par exemple ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_US_WEST_OREGON sur AWS. Ce SKU est disponible sur tous les clouds.

Étant donné que le SKU Serverless d'inférence en temps réel est partagé avec d’autres lignes de produits, filtrez toujours par billing_origin_product = 'GENIE' pour isoler l'utilisation de Genie.

Utilisation gratuite : SKU GENIE_FREE_USAGE

remarque

Le SKU GENIE_FREE_USAGE n'apparaît qu'à partir du 20 juillet 2026. L'utilisation gratuite consommée avant cette date n'est pas visible dans les tables du système.

Toute utilisation gratuite de Genie apparaît sous sku_name = 'GENIE_FREE_USAGE'. Ceci inclut :

  • Utilisation dans le cadre de l’allocation gratuite : Chaque utilisateur, à l'exception des Service Principal, dispose d'une allocation mensuelle gratuite de 150 DBU, qui est Reset le premier jour de chaque mois.
  • Jusqu'au 31 juillet 2026, l'utilisation de Genie One et des agents Genie est gratuite, incluse dans le SKU GENIE_FREE_USAGE.

Il s'agit d'un SKU à utilisation gratuite. Il suit la consommation, mais n'a pas de prix catalogue, il n'a donc pas d'entrée correspondante dans system.billing.list_prices. Lorsque vous joignez system.billing.usage à system.billing.list_prices, les lignes avec ce SKU ne renvoient aucune correspondance. Cela est prévu, car l'utilisation est gratuite.

Pour distinguer les produits au sein du SKU d'utilisation gratuite, filtrez sur usage_metadata.genie.surface:

  • GENIE_CODE: Utilisation gratuite de Genie Code
  • GENIE_ONE: Genie One
  • GENIE_AGENTS: Genie Agents

Utilisation de la query Genie

query billed Genie usage and cost

La query suivante renvoie l'intégralité de l'utilisation facturée de Genie, par utilisateur et par jour. Ceci inclut Genie Code et toute autre consommation Genie facturée sous un SKU payant. Cela exclut les lignes sous le SKU d'utilisation gratuite (GENIE_FREE_USAGE).

SQL
SELECT
u.account_id,
u.workspace_id,
u.usage_date,
u.identity_metadata.run_as AS run_as_user,
u.usage_metadata.genie.surface AS genie_surface,
u.usage_metadata.genie.channel AS genie_channel,
u.sku_name,
SUM(u.usage_quantity) AS dbus,
SUM(u.usage_quantity * lp.pricing.effective_list.default) AS list_cost
FROM system.billing.usage u
JOIN system.billing.list_prices lp
ON u.sku_name = lp.sku_name
AND u.usage_end_time >= lp.price_start_time
AND (lp.price_end_time IS NULL OR u.usage_end_time < lp.price_end_time)
WHERE u.billing_origin_product = 'GENIE'
AND u.sku_name != 'GENIE_FREE_USAGE'
GROUP BY
u.account_id,
u.workspace_id,
u.usage_date,
u.identity_metadata.run_as,
u.usage_metadata.genie.surface,
u.usage_metadata.genie.channel,
u.sku_name
ORDER BY u.usage_date DESC

Query l’usage gratuit et facturé de Genie par utilisateur

Pour voir un total mensuel cumulé par utilisateur de la consommation DBU gratuite ou facturée de Genie, utilisez la query suivante.

remarque

L'utilisation gratuite, dans le cadre du SKU GENIE_FREE_USAGE, ne start à apparaître qu'à partir du 20 juillet 2026. L'utilisation gratuite consommée avant cette date n'est pas visible dans les tables du système.

SQL
SELECT
u.identity_metadata.run_as AS user,
u.usage_metadata.genie.surface AS genie_surface,
SUM(CASE WHEN u.sku_name = 'GENIE_FREE_USAGE' THEN u.usage_quantity ELSE 0 END) AS free_dbus,
SUM(CASE WHEN u.sku_name != 'GENIE_FREE_USAGE' THEN u.usage_quantity ELSE 0 END) AS paid_dbus
FROM system.billing.usage u
WHERE u.billing_origin_product = 'GENIE'
AND u.usage_date >= DATE_TRUNC('MONTH', CURRENT_DATE)
GROUP BY
u.identity_metadata.run_as,
u.usage_metadata.genie.surface
ORDER BY user, genie_surface

Cela vous aide à comprendre quels utilisateurs consomment l'utilisation gratuite (offre gratuite Genie Code, Genie One et agents Genie) par rapport à l'utilisation facturée de Genie Code.

Comprendre la Tarifs promotionnelle pour Genie

Pendant la période promotionnelle (jusqu'au 31 janvier 2027), une réduction de 25 % s'applique à toute l'utilisation facturée de Genie. La réduction est automatiquement prise en compte dans la mesure des DBU. Pour calculer avec précision le coût de la liste, multipliez l'utilisation facturée par pricing.effective_list.default à partir de system.billing.list_prices. La façon dont la remise apparaît dans vos données de facturation dépend du produit Genie.

Tarifs promotionnels de Genie Code

Pour Genie Code, la tarification promotionnelle fonctionne comme suit :

  • **Allocation gratuite** : Chaque utilisateur reçoit 150 DBU gratuites par mois. Cette utilisation apparaît dans system.billing.usage mais n'est pas facturée.
  • Utilisation facturée au-delà du crédit gratuit : La remise de 25 % est appliquée directement dans la mesure des DBU, ce qui signifie que le usage_quantity reflète déjà la consommation réduite. Vous pouvez multiplier directement par le prix catalogue pour obtenir votre coût catalogue, sous réserve de votre remise négociée.

La réduction est appliquée dans la mesure des DBU plutôt que comme un SKU réduit distinct, car le SKU Serverless d'inférence en temps réel est partagé entre plusieurs lignes de produits. Il n'y a pas de SKU réduit séparé pour Genie.

Tarifs promotionnels de Genie One et Agents Genie

Jusqu'au 31 juillet 2026, toute l'utilisation de Genie One et Genie Agents est gratuite. Étant donné que ces produits utilisent la référence d'utilisation gratuite (GENIE_FREE_USAGE), aucune remise ou ajustement de DBU n'apparaît dans les données de facturation. Pour estimer ce que cette utilisation gratuite équivaudrait en utilisation facturée, utilisez la query dans Estimer le coût équivalent pour l'utilisation gratuite de Genie, qui inclut la remise de 25 % dans la colonne estimated_list_cost.

Estimer le coût équivalent pour l'utilisation gratuite de Genie

Si vous souhaitez estimer ce que coûterait votre utilisation gratuite (Genie One, Genie Agents ou l'allocation gratuite Genie Code) si elle était facturée au tarif Genie Code, vous pouvez obtenir un SKU proxy à partir de l'utilisation facturée existante de Genie Code de votre Workspace et appliquer ce prix.

Comment ça marche :

  1. Isoler les lignes d'utilisation gratuite : Filtrez system.billing.usagesku_name = 'GENIE_FREE_USAGE'.
  2. Résoudre une SKU régionale proxy par Workspace : Pour chaque workspace_id, trouvez l'enregistrement le plus récent dans system.billing.usagebilling_origin_product = 'GENIE' et sku_name != 'GENIE_FREE_USAGE', limité aux 30 derniers jours pour éviter une analyse complète de l'historique. Utilisez le sku_name de cet enregistrement comme proxy.
  3. Attacher le SKU de proxy : joignez les lignes d’utilisation gratuite à la recherche de SKU de proxy par Workspace sur workspace_id.
  4. Recherche de prix : joignez à system.billing.list_prices sur le sku_name résolu, en respectant la fenêtre de validité du prix.

La query suivante renvoie le coût estimé de l'utilisation gratuite, par utilisateur, pour le mois en cours.

SQL
-- Estimate the equivalent billed cost of GENIE_FREE_USAGE rows,
-- per user and workspace, with the 25% promotional discount applied.

WITH

-- Step 1: Isolate the free-usage rows for the current month
free_usage AS (
SELECT
account_id,
workspace_id,
identity_metadata.run_as AS run_as,
usage_metadata.genie.surface AS genie_surface,
usage_quantity,
usage_end_time
FROM system.billing.usage
WHERE billing_origin_product = 'GENIE'
AND sku_name = 'GENIE_FREE_USAGE'
AND usage_date >= DATE_TRUNC('MONTH', CURRENT_DATE)
),

-- Step 2: Find the latest billed GENIE SKU per workspace, scoped to the last 30 days
latest_real_sku AS (
SELECT
workspace_id,
max_by(sku_name, usage_start_time) AS proxy_sku_name
FROM system.billing.usage
WHERE billing_origin_product = 'GENIE'
AND sku_name != 'GENIE_FREE_USAGE'
AND usage_date >= CURRENT_DATE - 30
GROUP BY workspace_id
),

-- Step 3: Attach the proxy SKU to each free-usage row
resolved AS (
SELECT
f.account_id,
f.workspace_id,
f.run_as,
f.genie_surface,
f.usage_quantity,
f.usage_end_time,
r.proxy_sku_name AS pricing_sku_name
FROM free_usage f
LEFT JOIN latest_real_sku r
ON f.workspace_id = r.workspace_id
),

-- Step 4: Join to list prices on the resolved SKU + validity window, applying the 25% promotion
priced AS (
SELECT
r.account_id,
r.workspace_id,
r.run_as AS user,
r.genie_surface,
r.usage_quantity,
lp.pricing.effective_list.default AS list_price_per_unit,
r.usage_quantity * lp.pricing.effective_list.default * 0.75 AS estimated_list_cost
FROM resolved r
LEFT JOIN system.billing.list_prices lp
ON r.pricing_sku_name = lp.sku_name
AND r.usage_end_time >= lp.price_start_time
AND (lp.price_end_time IS NULL OR r.usage_end_time < lp.price_end_time)
)

-- Step 5: Aggregate per user, per workspace
SELECT
account_id,
workspace_id,
user,
genie_surface,
SUM(usage_quantity) AS total_dbus,
list_price_per_unit,
SUM(estimated_list_cost) AS total_estimated_list_cost
FROM priced
GROUP BY account_id, workspace_id, user, genie_surface, list_price_per_unit
ORDER BY workspace_id, user, genie_surface

La colonne estimated_list_cost applique la remise promotionnelle de 25 %, reflétant ce que cette utilisation gratuite coûterait en tant qu’utilisation facturée pendant la période promotionnelle (jusqu’au 31 janvier 2027). Consultez Comprendre les tarifs promotionnels de Genie.

remarque

Cette query exige qu'au moins un enregistrement d'utilisation facturé de Genie Code existe dans le Workspace. Si un Workspace n'a qu'une utilisation gratuite et aucune utilisation de Genie Code, le SKU proxy est NULL et aucun prix n'est résolu.

Ressources supplémentaires