Monitore e entenda seus custos com o Genie

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

Para obter informações sobre como definir orçamentos e controles de custo para o Genie, consulte Gerenciar orçamentos e controles de custo para o Genie.

Consultar o uso do Query Genie nas tabelas do sistema

Para analisar o uso e o custo do Genie, consulte a tabela system.billing.usage e faça uma junção com system.billing.list_prices. A system.billing.usage tabela é atualizada a cada poucas horas e contém uma linha para cada registro de uso.

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

Como o uso do Genie é mapeado para SKUs

O uso do Genie é dividido entre duas SKUs com base em se o uso é gratuito ou cobrado, não com base no produto Genie.

Use usage_metadata.genie.surface para identificar qual produto gerou o uso: GENIE_CODE, GENIE_ONEou GENIE_AGENTS.

Uso faturado: SKU de inferência sem servidor em tempo real

O uso do Genie que exceder a cota de uso gratuito é cobrado sob o SKU Inferência em tempo real Sem servidor, que está disponível em todas as nuvens. O nome exato do SKU inclui sua nuvem e região.

Por exemplo, o nome do SKU se parece com PREMIUM_SERVERLESS_REAL_TIME_INFERENCE_US_EAST.

Como a SKU de inferência em tempo real sem servidor é compartilhada com outras linhas de produto, sempre filtre por billing_origin_product = 'GENIE' para isolar o uso do Genie.

Uso gratuito: GENIE_FREE_USAGE SKU

Todo o uso gratuito do Genie aparece em sku_name = 'GENIE_FREE_USAGE'. Isso inclui:

• Uso sob a franquia gratuita: cada usuário, excluindo entidades de serviço, tem um subsídio mensal gratuito de 150 DBUs, que é redefinido 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 usuários é gratuito, registrado sob o GENIE_FREE_USAGE SKU. As entidades de serviço são excluídas, e o uso delas é cobrado.

Esse é um SKU de uso gratuito. Ele rastreia o consumo, mas não possui um preço de lista, portanto não tem uma entrada correspondente em system.billing.list_prices. Quando você unir system.billing.usage a system.billing.list_prices, as linhas com essa SKU não encontrarão correspondência. Isso é esperado, pois o uso é gratuito.

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

• GENIE_CODE: uso gratuito do Genie Code
• GENIE_ONE: Genie One
• GENIE_AGENTS: Agentes do Genie

Uso do Query Genie

Consultar uso e custo faturados do Genie

A consulta a seguir retorna todo o uso cobrado do Genie, por usuário e por dia. Isso inclui o Genie Code e qualquer outro uso do Genie mensurado em um SKU com preço definido. Ele exclui linhas sob a 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 o uso gratuito e cobrado do Genie por usuário

Para ver um total acumulado mensal do consumo por usuário de DBUs gratuitos e cobrados do Genie, use a seguinte consulta.

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

Isso ajuda você a entender quais usuários estão consumindo uso gratuito (Genie Code free allowance, Genie One e Genie Agents) em comparação com o uso cobrado do Genie Code.

Entender os preços promocionais do Genie

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

Preços promocionais do Genie Code

Para o Genie Code, o preço promocional funciona da seguinte maneira:

• Subsídio gratuito: cada usuário recebe 150 DBUs gratuitas por mês. Este uso aparece em system.billing.usage, mas não é cobrado.
• Uso faturado acima da cota gratuita: O desconto promocional de 25% é aplicado diretamente na medição de DBUs, ou seja, o usage_quantity já reflete o consumo com desconto. Você pode multiplicar diretamente pelo preço de lista para obter o custo de sua lista, sujeito ao seu desconto negociado.

O desconto é aplicado na medição em DBU, em vez de como uma SKU descontada separada, porque a SKU de inferência sem servidor em tempo real é compartilhada entre várias linhas de produtos. Não há nenhum SKU com desconto separado para o Genie.

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

Preços promocionais do Genie One e do Genie Agents

Até 31 de janeiro de 2027, o uso do Genie One e dos Agentes Genie pelos usuários é gratuito, e o uso do principal do serviço é cobrado. Como o uso gratuito desses produtos utiliza o SKU (GENIE_FREE_USAGE), nenhum desconto ou ajuste de DBU aparece nos dados de faturamento para eles. Para estimar o que esse uso gratuito equivaleria no uso cobrado, use a consulta em Estimar custo equivalente para uso gratuito do Genie, que inclui o desconto de 25% na estimated_list_cost coluna.

Estimar o custo equivalente para uso gratuito do Genie

Se você quiser estimar quanto seu uso gratuito (Genie One, Genie Agents ou a franquia gratuita do Genie Code) custaria se fosse cobrado pela tarifa do Genie Code, você pode identificar um SKU proxy com base no uso faturado existente do Genie Code no seu workspace e aplicar esse preço.

Como funciona:

1. Isolar linhas de uso gratuito: filtrar system.billing.usage em que sku_name = 'GENIE_FREE_USAGE'.
2. Determine uma SKU regional proxy por workspace: para cada workspace_id, localize o registro mais recente em system.billing.usage, em que billing_origin_product = 'GENIE' e sku_name != 'GENIE_FREE_USAGE', limitado aos últimos 30 dias para evitar uma varredura completa do histórico. Use esse registro sku_name como o proxy.
3. Anexar a SKU do proxy: junte as linhas de uso gratuito à pesquisa de SKU do proxy por workspace em workspace_id.
4. Pesquisa de preço: una com system.billing.list_prices no sku_name resolvido, respeitando a janela de validade do preço.

A consulta a seguir retorna o custo estimado de uso gratuito, por usuário, 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 estimated_list_cost coluna aplica o desconto promocional de 25%, refletindo quanto esse uso gratuito custaria como uso cobrado durante o período promocional (até 31 de janeiro de 2027). Consulte Entenda os preços promocionais do Genie.

Recursos adicionais

• Gerenciar orçamentos e controles de custo para o Genie
• Perguntas frequentes sobre custos e orçamentos do Genie