Monitorize e compreenda o custo do seu Genie

O uso do Genie aparece nas tabelas do sistema de faturação do Azure Databricks, onde pode consultar e analisar os custos do Genie e ver como os preços promocionais se refletem nos seus dados de utilização. Cada utilizador, excluindo os principais de serviço, recebe gratuitamente 150 unidades Databricks (DBUs) por mês, e este artigo mostra como acompanhar o consumo dessa autorização gratuita.

Note

Até 31 de janeiro de 2027, a utilização do Genie One e dos Agentes Genie pelos utilizadores é gratuita. Os service principals estão excluídos, e a sua utilização é faturada. O Genie Code continua a ser faturado acima da franquia gratuita de 150 DBU por utilizador, por mês.

Para informações sobre a definição de orçamentos e controlos de custos para o Genie, veja Gerir orçamentos e controlos de custos para o Genie.

Consultar o uso do Genie a partir de tabelas do sistema

Para analisar o uso e o custo do Genie, consulte a system.billing.usage tabela e junte-a a system.billing.list_prices. A system.billing.usage tabela atualiza-se a cada poucas horas e contém uma linha para cada registo de utilização.

As colunas seguintes são as mais relevantes para compreender o custo do Genie:

Column Description
billing_origin_product Definido como GENIE para toda a utilização do Genie.
sku_name O SKU de faturação. Varia consoante o uso gratuito ou faturado. Veja como o uso do Genie corresponde aos SKUs.
usage_quantity O número de DBUs consumidas.
usage_metadata.genie.surface Identifica qual produto Genie gerou a utilização (GENIE_CODE, GENIE_ONE, ou GENIE_AGENTS).
usage_metadata.genie.channel O canal de acesso, por exemplo UI.
identity_metadata.run_as O utilizador cuja identidade foi usada para executar a consulta.
product_features.genie.offering_type O tipo de oferta, por exemplo PAYGO.
custom_tags Inclui {"databricks-product": "genie"} para uso com Genie.

Como o uso do Genie se relaciona com os SKUs

O uso do Genie é dividido entre dois SKUs com base no uso gratuito ou faturado, e não no produto Genie.

SKU O que contém Faturado? Listado em list_prices?
Inferência sem servidor em tempo real (o nome exato do SKU varia consoante a nuvem e a região) Todo o uso do Genie faturado Sim Sim
GENIE_FREE_USAGE Toda a utilização gratuita do Genie. Consulte preços promocionais para saber o que é gratuito. No No

Use usage_metadata.genie.surface para identificar qual produto gerou a utilização: GENIE_CODE, GENIE_ONE, ou GENIE_AGENTS.

Utilização faturada: SKU de inferência sem servidor em tempo real

O uso do Genie que exceda a autorização de uso gratuito é faturado sob o SKU Serverless Real-Time Inference , disponível em todas as clouds. O nome exato do SKU inclui a respetiva nuvem e região.

Por exemplo, o nome SKU assemelha-se a PREMIUM_SERVERLESS_REAL_TIME_INFERENCE_US_EAST.

Como o SKU Serverless Real-Time Inference é partilhado com outras linhas de produtos, filtre sempre por billing_origin_product = 'GENIE' para isolar o uso do Genie.

Utilização gratuita: GENIE_FREE_USAGE SKU

Note

O GENIE_FREE_USAGE SKU só começa a aparecer a 20 de julho de 2026. O uso livre consumido antes desta data não é visível nas tabelas do sistema.

Toda a utilização gratuita do Genie aparece em sku_name = 'GENIE_FREE_USAGE'. Isto inclui:

  • Utilização ao abrigo da quota gratuita: Cada utilizador, excluindo as entidades de serviço, tem uma quota mensal gratuita de 150 DBUs, que é reposta no primeiro dia de cada mês.
  • Uso promocional do Genie One e dos Genie Agents: Até 31 de janeiro de 2027, o uso do Genie One e dos Genie Agents pelos utilizadores é gratuito, registado no GENIE_FREE_USAGE SKU. Os service principals estão excluídos, e a sua utilização é faturada.

Este é um SKU de uso gratuito. Regista o consumo mas não tem um preço de lista, pelo que não tem uma entrada correspondente em system.billing.list_prices. Quando se junta system.billing.usage com system.billing.list_prices, as linhas com este SKU não dão correspondência. Isto é esperado, porque o uso é gratuito.

Para distinguir entre produtos dentro do SKU de uso livre, filtre em usage_metadata.genie.surface:

  • GENIE_CODE: Uso gratuito do Código Genie
  • GENIE_ONE: Genie One
  • GENIE_AGENTS: Agentes Génio

Consultar o uso do Genie

Consultar o uso e o custo faturados do Genie

A consulta seguinte devolve todo o uso faturado do Genie, por utilizador e por dia. Isto inclui o Genie Code e qualquer outra utilização do Genie contabilizada ao abrigo de um SKU tarifado. Exclui as linhas incluídas no SKU de utilização gratuita (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 a utilização gratuita e faturada do Genie por utilizador

Para ver o total mensal do consumo gratuito por utilizador versus o faturado de DBU Genie, utilize a seguinte consulta.

Note

A utilização gratuita, sob o GENIE_FREE_USAGE SKU, só começa a aparecer a 20 de julho de 2026. O uso livre consumido antes desta data não é visível nas tabelas do 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

Isto ajuda-o a compreender quais os utilizadores que estão a consumir utilização gratuita (franquia gratuita do Genie Code, Genie One e Genie Agents) por oposição à utilização faturada do Genie Code.

Compreenda os preços promocionais do Genie

Durante o período promocional (até 31 de janeiro de 2027), aplica-se um desconto de 25% a todo o uso faturado do Genie. O desconto é automaticamente considerado na medição da DBU. Para calcular com precisão o custo de lista, multiplique o uso faturado por pricing.effective_list.default partir de system.billing.list_prices. A forma como o desconto aparece nos seus dados de faturação depende do produto Genie.

Preços promocionais do Código Genie

Para o Genie Code, os preços promocionais funcionam da seguinte forma:

  • Franquia gratuita: Cada utilizador recebe 150 DBUs gratuitas por mês. Esta utilização aparece em system.billing.usage, mas não é faturada.
  • Utilização faturada acima da autorização gratuita: O desconto promocional de 25% é aplicado diretamente na medição da DBU, o que significa que o usage_quantity valor já reflete o consumo com desconto. Pode multiplicar diretamente pelo preço de tabela para obter o seu custo de tabela, tendo em conta o desconto negociado.

O desconto é aplicado na medição de DBU, em vez de como um SKU com desconto separado, porque o SKU de Serverless Real-Time Inference é partilhado entre várias linhas de produto. Não existe um SKU separado com desconto para o Genie.

O desconto promocional é combinado com os descontos aplicáveis no SKU Serverless Real-Time Inference.

Preços promocionais da Genie One e da Genie Agents

Até 31 de janeiro de 2027, a utilização do Genie One e dos Agentes Genie pelos utilizadores é gratuita, e a utilização do principal do serviço é faturada. Como o uso gratuito destes produtos utiliza o SKU (GENIE_FREE_USAGE) de uso livre, não aparece nenhum desconto ou ajuste DBU nos dados de faturação correspondentes. Para estimar o que este uso gratuito equivaleria em consumo faturado, use a consulta em Estimar custo equivalente para uso gratuito do Genie, que inclui o desconto de 25% na estimated_list_cost coluna.

Estima o custo equivalente para uso gratuito do Genie

Se quiseres estimar quanto custaria o teu uso gratuito (Genie One, Agentes Genie ou a licença gratuita do Código Genie) se fosse faturado à taxa do Código Genie, podes resolver um SKU proxy a partir do uso já faturado do Código Genie no teu espaço de trabalho e aplicar esse preço.

Como funciona:

  1. Isolar linhas de utilização gratuita: Filtrar system.billing.usage em que sku_name = 'GENIE_FREE_USAGE'.
  2. Determinar um SKU regional proxy por espaço de trabalho: Para cada workspace_id, encontrar o registo mais recente em system.billing.usage em que billing_origin_product = 'GENIE' e sku_name != 'GENIE_FREE_USAGE', limitando a pesquisa aos últimos 30 dias para evitar um varrimento completo do histórico. Use o sku_name desse registo como proxy.
  3. Anexe o SKU proxy: Junte as linhas de uso livre à pesquisa de SKU proxy por workspace em workspace_id.
  4. Consulta de preço: Fazer junção com system.billing.list_prices com base no sku_name resolvido, respeitando a janela de validade do preço.

A consulta seguinte devolve o custo estimado de utilização gratuita, por utilizador, para o mês atual.

-- 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

A coluna estimated_list_cost aplica o desconto promocional de 25%, refletindo quanto este uso gratuito custaria se fosse faturado durante o período promocional (até 31 de janeiro de 2027, inclusive). Consulte Compreender os preços promocionais do Genie.

Note

Esta consulta requer a existência de pelo menos um registo de utilização faturada do Código Genie no espaço de trabalho. Se um espaço de trabalho tiver apenas utilização gratuita e nenhuma utilização do Código Genie, o SKU proxy é NULL e não é determinado qualquer preço.

Recursos adicionais

  • Last updated on