Monitore e entenda seu custo do Genie
Este artigo explica como o uso do Genie aparece nas tabelas do sistema de faturamento do Databricks, como consultar e analisar seus custos do Genie e como os preços promocionais são refletidos em seus dados de uso. Também aborda como entender o consumo da permissão gratuita que o Genie fornece: cada usuário, excluindo Service Principal, recebe 150 DBUs gratuitos por mês.
Até 31 de julho de 2026, o uso do Genie One e do Genie Agents é gratuito. O Genie Code continua sendo cobrado além do subsídio gratuito de 150 DBU por usuário por mês.
Para obter informação sobre como definir orçamentos e controles de custo para o Genie, consulte Gerenciar orçamentos e controles de custo para o Genie.
Query do uso do Genie de tabelas do sistema
Para analisar o uso e o custo do Genie, faça uma query na tabela system.billing.usage e faça um join com system.billing.list_prices. A tabela system.billing.usage é 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:
Coluna | Descrição |
|---|---|
| Definir como |
| A SKU de faturamento. Varia se o uso é gratuito ou faturado. Consulte Como o uso do Genie se mapeia para as SKUs. |
| O número de DBUs consumidas. |
| Identifica qual produto Genie gerou o uso ( |
| O canal de acesso, por exemplo |
| O usuário cuja identidade foi usada para executar a query. |
| O tipo de oferta, por exemplo, |
| Inclui |
Como o uso do Genie é mapeado para SKUs
O uso do Genie é dividido em dois SKUs, com base em se o uso é gratuito ou cobrado, e não com base no produto Genie.
sku | O que ele contém? | Faturado? | Listado em |
|---|---|---|---|
Inferência Serverless em Tempo Real (por exemplo, | Todo o uso faturado do Genie | Sim | Sim |
| Todo uso gratuito do Genie. Consulte os preços promocionais para saber o que é gratuito. | Não | Não |
Use usage_metadata.genie.surface para identificar qual produto gerou o uso: GENIE_CODE, GENIE_ONE ou GENIE_AGENTS.
Uso faturado: SKU de Inferência serverless em tempo real
O uso do Genie que excede o subsídio de uso gratuito é cobrado no SKU de Inferência Serverless em Tempo Real . O nome exato do SKU inclui sua cloud e região, por exemplo ENTERPRISE_SERVERLESS_REAL_TIME_INFERENCE_US_WEST_OREGON na AWS. Este SKU está disponível em todas as clouds.
Como a SKU de Inferência Serverless em Tempo Real é 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
O SKU GENIE_FREE_USAGE somente começa a aparecer em 20 de julho de 2026. O uso gratuito consumido antes desta data não fica visível nas tabelas do sistema.
Todo o uso gratuito do Genie aparece em sku_name = 'GENIE_FREE_USAGE'. Isso inclui:
- Uso sob o limite gratuito : Cada usuário, excluindo os Service Principal, tem um limite mensal gratuito de 150 DBUs, que se redefine no primeiro dia de cada mês.
- Até 31 de julho de 2026, todo o uso do Genie One e do Genie Agents é gratuito, capturado sob o SKU
GENIE_FREE_USAGE.
Esta é uma SKU de uso gratuito. Ele acompanha o consumo, mas não possui preço de tabela, portanto não tem nenhuma entrada correspondente em system.billing.list_prices. Quando você une system.billing.usage com system.billing.list_prices, as linhas com esta SKU não retornam correspondência. Isso é esperado, porque o uso é gratuito.
Para distinguir entre produtos dentro do SKU de uso gratuito, filtre por usage_metadata.genie.surface:
GENIE_CODE: Uso gratuito do Genie CodeGENIE_ONE: Genie OneGENIE_AGENTS: Genie Agents
Query do uso do Genie
Consultar uso e custo faturados do Genie
A seguinte query retorna todo o uso faturado do Genie, por usuário e por dia. Isso inclui o Genie Code e qualquer outro uso do Genie tarifado sob uma SKU precificada. 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
Query do uso gratuito e faturado do Genie por usuário
Para ver um total mensal acumulado do consumo de DBU do Genie gratuito versus cobrado por usuário, use a query a seguir.
O uso gratuito, sob o SKU GENIE_FREE_USAGE, só começa a aparecer em 20 de julho de 2026. O uso gratuito consumido antes desta data não está 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
Isso ajuda a entender quais usuários estão consumindo o uso gratuito (permissão gratuita do Genie Code, Genie One e Genie Agents) versus o uso faturado do Genie Code.
Compreenda os preços promocionais para o Genie
Durante o período promocional (até 31 de janeiro de 2027), um desconto de 25% é aplicado a todo o uso faturado do Genie. O desconto é automaticamente considerado na medição de DBU. Para calcular com precisão o custo da lista, multiplique o uso faturado por pricing.effective_list.default de system.billing.list_prices. Como o desconto aparece em seus dados de faturamento depende do produto Genie.
Genie Code preços promocionais
Para o Genie Code, os preços promocionais funcionam da seguinte forma:
- Franquia gratuita : Cada usuário recebe 150 DBUs gratuitas por mês. Este uso aparece em
system.billing.usage, mas não é faturado. - Uso faturado acima da franquia gratuita : O desconto de 25% é aplicado diretamente na medição de DBU, o que significa que o
usage_quantityjá reflete o consumo com desconto. É possível multiplicar diretamente pelo preço de tabela para obter o seu custo de tabela, sujeito ao seu desconto negociado.
O desconto é aplicado na medição de DBU em vez de como um SKU com desconto separado, porque o SKU de Inferência em tempo real Serverless é compartilhado entre várias linhas de produtos. Não há um SKU com desconto separado para o Genie.
Preços promocionais do Genie One e dos Genie Agents
Até 31 de julho de 2026, todo o uso do Genie One e do Genie Agents é gratuito. Como esses produtos usam o SKU de uso gratuito (GENIE_FREE_USAGE), nenhum ajuste de desconto ou DBU aparece nos dados de faturamento. Para estimar a qual valor este uso gratuito equivaleria em uso faturado, use a query em Estimar custo equivalente para uso gratuito do Genie, que inclui o desconto de 25% na coluna estimated_list_cost.
Estimar custo equivalente para uso gratuito do Genie
Se quiser estimar quanto custaria seu uso gratuito (Genie One, Genie Agents ou o subsídio gratuito do Genie Code) se fosse cobrado à taxa do Genie Code, você pode resolver um SKU proxy a partir do uso cobrado existente do Genie Code do seu workspace e aplicar esse preço.
Como funciona:
- Isolar linhas de uso gratuito : Filtrar
system.billing.usageondesku_name = 'GENIE_FREE_USAGE'. - Resolver uma SKU regional de proxy por workspace : Para cada
workspace_id, encontre o registro mais recente emsystem.billing.usageondebilling_origin_product = 'GENIE'esku_name != 'GENIE_FREE_USAGE', abrangendo os últimos 30 dias para evitar uma varredura completa do histórico. Use osku_namedesse registro como proxy. - Anexe o SKU de proxy : Una as linhas de uso gratuito à pesquisa de SKU de proxy por workspace em
workspace_id. - Pesquisa de preços : Faça join com
system.billing.list_pricesnosku_nameresolvido, respeitando a janela de validade do preço.
A query a seguir retorna o custo estimado do 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 coluna estimated_list_cost aplica o desconto promocional de 25%, refletindo o custo que este uso gratuito teria como uso faturado durante o período promocional (até 31 de janeiro de 2027). Consulte Compreender os preços promocionais do Genie.
Esta query exige que exista pelo menos um registro de uso faturado do Genie Code no workspace. Se um workspace tiver apenas uso gratuito e nenhum uso do Genie Code, o SKU de proxy será NULL e nenhum preço será resolvido.
Perguntas Frequentes
Por que o gasto por usuário na IU de orçamento não concilia com as tabelas do sistema?
Os gastos exibidos na página de detalhes do orçamento e em system.billing.usage podem diferir quando comparados no mesmo momento. Isso porque a UI do orçamento faz refresh com muito mais frequência do que as tabelas do sistema, que atualizam a cada poucas horas. Dadas essas diferenças de latência, não se espera que os números se conciliem. Use as tabelas do sistema como fonte da verdade para um uso preciso.
Por que não vejo nenhum uso gratuito consumido antes de 20 de julho de 2026?
A visibilidade do uso gratuito, sob o SKU GENIE_FREE_USAGE, foi implementada em 20 de julho de 2026. O uso gratuito consumido antes dessa data não é preenchido retroativamente.
O uso gratuito considera o desconto promocional de 25%?
O desconto promocional de 25% é aplicado diretamente à medição de DBU, mas apenas ao uso faturado. O uso gratuito, que inclui o uso abaixo do limite gratuito, bem como todo o uso do Genie One e dos Genie Agents até 31 de julho de 2026, é medido pela taxa total. Para estimar o custo equivalente do uso gratuito, caso fosse faturado, considere o desconto de 25% para o período promocional, conforme mostrado em Estimar custo equivalente para uso gratuito do Genie. Isso se destina a fornecer aos usuários o limite total de 150 DBU por mês, quer o período promocional esteja ativo ou não.