Supervisa y comprende el coste de Genie

El uso de Genie aparece en las tablas del sistema de facturación de Azure Databricks, donde puedes consultar y analizar tus costes de Genie y ver cómo se refleja el precio promocional en tus datos de uso. Cada usuario, excluyendo a los principales de servicio, recibe 150 unidades Databricks (DBUs) al mes de forma gratuita, y este artículo muestra cómo hacer un seguimiento del consumo de esa franquicia gratuita.

Note

Hasta el 31 de enero de 2027, el uso de Genie One y Genie Agents por parte de los usuarios es gratuito. Las entidades de servicio quedan excluidas y su uso se factura. El uso de Genie Code se factura una vez superada la asignación gratuita de 150 DBU por usuario y mes.

Para obtener información sobre cómo establecer presupuestos y controles de costos para Genie, consulte Administración de presupuestos y controles de costos para Genie.

Consulta del uso de Genie desde tablas del sistema

Para analizar el uso y el costo de Genie, consulte la system.billing.usage tabla y acompáñela con system.billing.list_prices. La system.billing.usage tabla se actualiza cada pocas horas y contiene una fila para cada registro de uso.

Las columnas siguientes son más relevantes para comprender el costo de Genie:

Column Descripción
billing_origin_product Establézcalo en GENIE para todo el uso de Genie.
sku_name El SKU de facturación. Varía según si el uso es gratuito o se factura. Consulte cómo se corresponde el uso de Genie con los SKU.
usage_quantity El número de DBUs consumidas.
usage_metadata.genie.surface Identifica qué producto de Genie generó el uso (GENIE_CODE, GENIE_ONEo GENIE_AGENTS).
usage_metadata.genie.channel Canal de acceso, por ejemplo UI.
identity_metadata.run_as Usuario cuya identidad se usó para ejecutar la consulta.
product_features.genie.offering_type El tipo de oferta, por ejemplo PAYGO.
custom_tags Incluye {"databricks-product": "genie"} para usar Genie.

Cómo se corresponde el uso de Genie con las SKU

El uso de Genie se divide en dos SKU en función de si el uso es gratuito o facturado, no basado en el producto Genie.

SKU Qué contiene ¿Facturado? ¿Incluido en list_prices?
Inferencia sin servidor en tiempo real (el nombre exacto del SKU varía según la nube y la región) Todo el uso facturado de Genie
GENIE_FREE_USAGE Todo uso gratuito de Genie. Consulta precios promocionales para obtener lo que es gratis. No No

Use usage_metadata.genie.surface para identificar qué producto generó el uso: GENIE_CODE, GENIE_ONEo GENIE_AGENTS.

Uso facturado: SKU de inferencia en tiempo real sin servidor

El uso de Genie que supera el límite de uso gratuito se factura conforme al SKU Serverless Real-Time Inference, que está disponible en todas las nubes. El nombre exacto de la SKU incluye su nube y su región.

Por ejemplo, el nombre del SKU es como PREMIUM_SERVERLESS_REAL_TIME_INFERENCE_US_EAST.

Dado que la SKU de inferencia en tiempo real sin servidor se comparte con otras líneas de productos, filtre siempre por billing_origin_product = 'GENIE' para aislar el uso de Genie.

Uso gratuito: SKU GENIE_FREE_USAGE

Note

La GENIE_FREE_USAGE SKU solo comienza a aparecer el 20 de julio de 2026. El uso gratuito consumido antes de esta fecha no es visible en las tablas del sistema.

Todo el uso gratuito de Genie aparece en sku_name = 'GENIE_FREE_USAGE'. Esto incluye lo siguiente:

  • Uso dentro de la asignación gratuita: Cada usuario, excepto los principales de servicio, dispone de una asignación mensual gratuita de 150 DBU, que se restablece el primer día de cada mes.
  • Uso promocional de Genie One y Genie Agents: Hasta el 31 de enero de 2027, el uso de Genie One y Genie Agents por parte de los usuarios es gratuito, registrado bajo el GENIE_FREE_USAGE SKU. Las entidades de servicio quedan excluidas y su uso se factura.

Se trata de una SKU de uso gratuita. Realiza un seguimiento del consumo, pero no lleva un precio de lista, por lo que no tiene ninguna entrada correspondiente en system.billing.list_prices. Cuando se combinan system.billing.usage y system.billing.list_prices, las filas con este SKU no devuelven ninguna coincidencia. Esto es lo esperado, ya que el uso es gratuito.

Para distinguir entre productos dentro de la SKU de uso gratuito, filtre por usage_metadata.genie.surface:

  • GENIE_CODE: uso gratuito de código de Genie
  • GENIE_ONE: Genio Uno
  • GENIE_AGENTS: Agentes de Genie

Uso de Query Genie

Consultar el uso y el costo de Genie facturados

La consulta siguiente devuelve todo el uso facturado de Genie, por usuario y por día. Esto incluye Genie Code y cualquier otro uso de Genie medido bajo una SKU de pago. Excluye las filas incluidas en la SKU de uso gratuito (GENIE_FREE_USAGE).

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

Consultar el uso gratuito y facturado de Genie por usuario

Para ver un total acumulado mensual del consumo de DBU de Genie gratuito frente al facturado, por usuario, utilice la siguiente consulta.

Note

El uso gratuito, bajo la referencia GENIE_FREE_USAGE, no comenzará a aplicarse hasta el 20 de julio de 2026. El uso gratuito consumido antes de esta fecha no es visible en las tablas del sistema.

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

Esto le ayuda a comprender qué usuarios consumen uso gratuito (asignación gratuita de Genie Code, Genie One y Genie Agents) frente al uso facturado de Genie Code.

Descripción de los precios promocionales de Genie

Durante el período promocional (hasta el 31 de enero de 2027), se aplica un descuento de 25% a todos los usos facturados de Genie. El descuento se tiene en cuenta automáticamente en la medición de DBU. Para calcular con precisión el coste de catálogo, multiplica el uso facturado por pricing.effective_list.default de system.billing.list_prices. La forma en que aparece el descuento en los datos de facturación depende del producto Genie.

Precios promocionales de Genie Code

Para Genie Code, los precios promocionales funcionan de la siguiente manera:

  • Asignación gratuita: cada usuario recibe 150 DBU gratis al mes. Este uso aparece en system.billing.usage pero no se factura.
  • Consumo facturado por encima de la franquicia gratuita: El descuento promocional de 25% se aplica directamente en la medición DBU, lo que significa que ya refleja usage_quantity el consumo con descuento. Puedes multiplicar directamente por el precio de catálogo para obtener tu coste de catálogo, sujeto al descuento que hayas negociado.

El descuento se aplica en la medición de DBU en lugar de como una SKU con descuento independiente, ya que la SKU de inferencia en tiempo real sin servidor se comparte entre varias líneas de productos. No hay ninguna SKU con descuento independiente para Genie.

El descuento promocional se combina con los descuentos aplicables en el SKU de inferencia en tiempo real sin servidor.

Precios promocionales de Genie One y Genie Agents

Hasta el 31 de enero de 2027, el uso de Genie One y Genie Agents por parte de los usuarios es gratuito, y el uso principal del servicio se factura. Como el uso gratuito de estos productos utiliza el SKU (GENIE_FREE_USAGE) de uso libre, no aparece ningún descuento ni ajuste DBU en los datos de facturación correspondientes. Para calcular lo que este uso gratuito equivaldría al uso facturado, use la consulta en Estimación del costo equivalente para el uso gratuito de Genie, que incluye el descuento de 25% en la estimated_list_cost columna.

Estimación del costo equivalente para el uso gratuito de Genie

Si desea calcular cuánto costaría su uso gratuito (Genie One, Genie Agents o la cuota gratuita de Genie Code) si se facturara según la tarifa de Genie Code, puede identificar una SKU de referencia a partir del uso facturado existente de Genie Code en su espacio de trabajo y aplicar ese precio.

Cómo funciona:

  1. Aislar las filas de uso gratuito: Filtrar system.billing.usage donde sku_name = 'GENIE_FREE_USAGE'.
  2. Resolver una SKU regional proxy por espacio de trabajo: Para cada workspace_id, buscar el registro más reciente en system.billing.usage donde billing_origin_product = 'GENIE' y sku_name != 'GENIE_FREE_USAGE', limitado a los últimos 30 días para evitar un escaneo completo del historial. Use ese registro sku_name como proxy.
  3. Adjuntar la SKU proxy: Unir las filas de uso gratuito a la consulta de la SKU proxy por espacio de trabajo en workspace_id.
  4. Consulta de precios: Unir a system.billing.list_prices en el sku_name resuelto, respetando el periodo de validez del precio.

La consulta siguiente devuelve el costo estimado de uso gratuito, por usuario, para el mes actual.

-- 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 estimated_list_cost columna aplica el descuento promocional de 25%, que refleja lo que este uso gratuito costaría como uso facturado durante el período promocional (hasta el 31 de enero de 2027). Consulte Descripción de los precios promocionales de Genie.

Note

Esta consulta requiere que exista al menos un registro de uso de Genie Code facturado en el área de trabajo. Si un espacio de trabajo solo tiene uso gratuito y ningún uso de Genie Code, el SKU proxy es NULL y no se determina ningún precio.

Recursos adicionales