Monitore e entenda seu custo do Genie
O uso do Genie aparece nas tabelas do sistema de faturamento do Databricks, onde você pode fazer query e analisar seus custos com o Genie e ver como os preços promocionais são refletidos em seus dados de uso. Cada usuário, excluindo Service Principal, recebe 150 unidades do Databricks (DBUs) por mês gratuitamente, e este artigo mostra como rastrear o consumo dessa franquia gratuita.
Até 31 de janeiro de 2027, o uso do Genie One e dos Genie Agents pelos usuários é gratuito. Os Service Principal são excluídos e seu uso é cobrado. O Genie Code continua sendo cobrado além da franquia gratuita de 150 DBU por usuário ao 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.
- 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 a SKU
GENIE_FREE_USAGE. Service Principal são excluídos e seu uso é cobrado.
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 promocional de 25% é aplicado diretamente na medição de DBU, o que significa que o
usage_quantityjá reflete o consumo com desconto. Você pode multiplicar diretamente pelo preço de tabela para obter 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.
O desconto promocional é combinado com descontos aplicáveis na SKU de inferência em tempo real Serverless.
Preços promocionais do Genie One e dos Genie Agents
Até 31 de janeiro de 2027, o uso do Genie One e dos Genie Agents por usuários é gratuito, e o uso do service principal é cobrado. Como o uso gratuito desses produtos utiliza o SKU de uso gratuito (GENIE_FREE_USAGE), nenhum desconto ou ajuste de DBU aparece nos dados de faturamento para ele. Para estimar a que esse uso gratuito equivaleria em uso faturado, use a query em Estimate equivalent cost for free Genie usage, 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.